@enokdev/springdocs-mcp 1.2.8 → 1.4.1

package/build/services/migration-sources.js

@@ -0,0 +1,48 @@
+// Migration guides of projects other than Spring Boot: raw markdown pages of their wiki
+// (raw host of the code forge). Pure helpers, no network access here.
+//
+// Verified against the network: the raw endpoint answers a missing page with a real 404 (unlike
+// the HTML wiki, which redirects to the home page with a 200).
+//   Framework: Spring-Framework-<major.minor>-Release-Notes.md (5.3, 6.0, 6.1, 6.2, 7.0 exist)
+//   Batch:     Spring-Batch-<major.minor>-Migration-Guide.md   (5.0, 6.0 exist)
+// Candidates not implemented: Spring Security (docs.spring.io/spring-security/reference/<v>/migration/
+// shows the guide of the version's major, not of a target version) and Spring AI (a single
+// upgrade-notes.html page for all versions).
+export const MIGRATION_PROJECTS = ['spring-boot', 'spring-framework', 'spring-batch'];
+const RAW_SOURCES = {
+    'spring-framework': { repo: 'spring-framework', displayName: 'Spring Framework', document: 'release-notes' },
+    'spring-batch': { repo: 'spring-batch', displayName: 'Spring Batch', document: 'migration-guide' },
+};
+export function isMigrationProject(value) {
+    return MIGRATION_PROJECTS.includes(value);
+}
+export function projectDisplayName(project) {
+    return project === 'spring-boot' ? 'Spring Boot' : RAW_SOURCES[project].displayName;
+}
+const label = (document) => (document === 'migration-guide' ? 'Migration Guide' : 'Release Notes');
+export function rawWikiTitle(project, version) {
+    const source = RAW_SOURCES[project];
+    return `${source.displayName} ${version} ${label(source.document)}`;
+}
+export function rawWikiUrl(project, version) {
+    const source = RAW_SOURCES[project];
+    const page = `${source.displayName.replace(' ', '-')}-${version}-${label(source.document).replace(' ', '-')}`;
+    return `https://raw.githubusercontent.com/wiki/spring-projects/${source.repo}/${page}.md`;
+}
+/** `auto` and the project's only document resolve to it; the other one is rejected before any request. */
+export function resolveRawDocument(project, document) {
+    const source = RAW_SOURCES[project];
+    if (document !== 'auto' && document !== source.document) {
+        throw new Error(`${source.displayName} only has "${source.document}" documents (document="${document}" is not available)`);
+    }
+    return source.document;
+}
+/** A real page is markdown, never an HTML document (home page or error page). */
+export function assertRawMarkdown(body, title, url) {
+    const text = body.trim();
+    if (!text || /^<(!doctype|html)/i.test(text)) {
+        throw new Error(`Wiki page not found: ${title} (${url})`);
+    }
+    return text;
+}
+//# sourceMappingURL=migration-sources.js.map

package/build/services/migration-sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-sources.js","sourceRoot":"","sources":["../../src/services/migration-sources.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,sEAAsE;AACtE,EAAE;AACF,gGAAgG;AAChG,+DAA+D;AAC/D,+FAA+F;AAC/F,gFAAgF;AAChF,uGAAuG;AACvG,2FAA2F;AAC3F,6CAA6C;AAM7C,MAAM,CAAC,MAAM,kBAAkB,GAAgC,CAAC,aAAa,EAAE,kBAAkB,EAAE,cAAc,CAAC,CAAC;AAQnH,MAAM,WAAW,GAA+C;IAC9D,kBAAkB,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,eAAe,EAAE;IAC5G,cAAc,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,iBAAiB,EAAE;CACnG,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAQ,kBAAwC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAyB;IAC1D,OAAO,OAAO,KAAK,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC;AACtF,CAAC;AAED,MAAM,KAAK,GAAG,CAAC,QAA8B,EAAE,EAAE,CAAC,CAAC,QAAQ,KAAK,iBAAiB,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;AAEzH,MAAM,UAAU,YAAY,CAAC,OAA4B,EAAE,OAAe;IACxE,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO,GAAG,MAAM,CAAC,WAAW,IAAI,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAA4B,EAAE,OAAe;IACtE,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;IAC9G,OAAO,0DAA0D,MAAM,CAAC,IAAI,IAAI,IAAI,KAAK,CAAC;AAC5F,CAAC;AAED,0GAA0G;AAC1G,MAAM,UAAU,kBAAkB,CAChC,OAA4B,EAC5B,QAAuC;IAEvC,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,CAAC,WAAW,cAAc,MAAM,CAAC,QAAQ,0BAA0B,QAAQ,qBAAqB,CAAC,CAAC;IAC7H,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC;AACzB,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,KAAa,EAAE,GAAW;IACxE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACzB,IAAI,CAAC,IAAI,IAAI,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,KAAK,GAAG,GAAG,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/build/services/release-notes.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Release notes helpers: pure functions used by the get_release_notes tool.
+ */
+export type ReleaseFocus = 'all' | 'breaking-changes' | 'new-features' | 'deprecations';
+/**
+ * Normalizes a user-supplied release version: strips a leading "v", returns
+ * undefined for absent/empty/"latest" and throws on any invalid format.
+ * Accepts a full version ("3.5.0", "4.2.0-M2") or a minor ("3.5").
+ */
+export declare function normalizeReleaseVersion(version?: unknown): string | undefined;
+/** True for a normalized "X.Y" minor (as opposed to a full release version). */
+export declare function isMinorVersion(normalized: string): boolean;
+/**
+ * Among GitHub releases, the highest stable (X.Y.Z, no pre-release) patch of the given
+ * "X.Y" minor, or undefined. Numeric comparison: 3.1 never matches 3.10.
+ */
+export declare function latestStableOfMinor<T extends {
+    tag_name?: unknown;
+    prerelease?: unknown;
+}>(releases: T[], minor: string, tagPrefix?: string): T | undefined;
+/** Filters a GitHub release body according to the requested focus. */
+export declare function filterReleaseBody(body: string | null | undefined, focus: ReleaseFocus): string;
+//# sourceMappingURL=release-notes.d.ts.map

package/build/services/release-notes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-notes.d.ts","sourceRoot":"","sources":["../../src/services/release-notes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,kBAAkB,GAAG,cAAc,GAAG,cAAc,CAAC;AASxF;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAgB7E;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,EACxF,QAAQ,EAAE,CAAC,EAAE,EACb,KAAK,EAAE,MAAM,EACb,SAAS,SAAK,GACb,CAAC,GAAG,SAAS,CAiBf;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,YAAY,GAAG,MAAM,CAiC9F"}

package/build/services/release-notes.js

@@ -0,0 +1,94 @@
+/**
+ * Release notes helpers: pure functions used by the get_release_notes tool.
+ */
+import { scanFences } from './markdown.js';
+const VERSION_PATTERN = /^\d+\.\d+\.\d+(-[A-Za-z0-9.]+)?$/;
+const MINOR_PATTERN = /^\d+\.\d+$/;
+const STABLE_PATCH_PATTERN = /^(\d+)\.(\d+)\.(\d+)$/;
+const BREAKING_PATTERN = /breaking|remov(e|ed|al)|incompatib|no longer|migrat/i;
+const DEPRECATION_PATTERN = /deprecat/i;
+const HEADING_PATTERN = /^(#{1,6})\s/;
+/**
+ * Normalizes a user-supplied release version: strips a leading "v", returns
+ * undefined for absent/empty/"latest" and throws on any invalid format.
+ * Accepts a full version ("3.5.0", "4.2.0-M2") or a minor ("3.5").
+ */
+export function normalizeReleaseVersion(version) {
+    if (version === undefined || version === null || version === '' || version === 'latest') {
+        return undefined;
+    }
+    if (typeof version !== 'string') {
+        throw new Error(`Invalid version ${JSON.stringify(version)}: expected a string like "3.5.0", "3.5" or "4.2.0-M2"`);
+    }
+    const normalized = version.startsWith('v') ? version.slice(1) : version;
+    if (!VERSION_PATTERN.test(normalized) && !MINOR_PATTERN.test(normalized)) {
+        throw new Error(`Invalid version "${version}": expected a release version like "3.5.0", "3.5" (latest release of that minor) or "4.2.0-M2"`);
+    }
+    return normalized;
+}
+/** True for a normalized "X.Y" minor (as opposed to a full release version). */
+export function isMinorVersion(normalized) {
+    return MINOR_PATTERN.test(normalized);
+}
+/**
+ * Among GitHub releases, the highest stable (X.Y.Z, no pre-release) patch of the given
+ * "X.Y" minor, or undefined. Numeric comparison: 3.1 never matches 3.10.
+ */
+export function latestStableOfMinor(releases, minor, tagPrefix = '') {
+    let best;
+    let bestPatch = -1;
+    for (const release of releases) {
+        if (typeof release?.tag_name !== 'string' || release.prerelease === true)
+            continue;
+        let tag = release.tag_name;
+        if (tagPrefix && tag.startsWith(tagPrefix))
+            tag = tag.slice(tagPrefix.length);
+        else if (tag.startsWith('v'))
+            tag = tag.slice(1);
+        const match = STABLE_PATCH_PATTERN.exec(tag);
+        if (!match || `${match[1]}.${match[2]}` !== minor)
+            continue;
+        const patch = Number(match[3]);
+        if (patch > bestPatch) {
+            best = release;
+            bestPatch = patch;
+        }
+    }
+    return best;
+}
+/** Filters a GitHub release body according to the requested focus. */
+export function filterReleaseBody(body, focus) {
+    if (!body)
+        return '';
+    if (focus === 'all')
+        return body;
+    // GitHub sometimes returns CRLF line endings
+    const lines = body.split(/\r?\n/);
+    // A line inside a code block (or a fence line) is never a heading
+    const scan = scanFences(lines);
+    const isHeading = (index) => scan[index].inCode || scan[index].isFence ? null : HEADING_PATTERN.exec(lines[index]);
+    if (focus === 'new-features') {
+        const result = [];
+        let level = 0; // 0 = not inside the section
+        for (const [index, line] of lines.entries()) {
+            const heading = isHeading(index);
+            if (level === 0) {
+                if (heading && /new features/i.test(line)) {
+                    level = heading[1].length;
+                    result.push(line);
+                }
+            }
+            else {
+                if (heading && heading[1].length <= level)
+                    break;
+                result.push(line);
+            }
+        }
+        return result.join('\n').trim();
+    }
+    const pattern = focus === 'breaking-changes' ? BREAKING_PATTERN : DEPRECATION_PATTERN;
+    return lines
+        .filter((line, index) => !isHeading(index) && pattern.test(line))
+        .join('\n');
+}
+//# sourceMappingURL=release-notes.js.map

package/build/services/release-notes.js.map

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

package/build/services/search-index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * In-memory BM25 full-text index over documentation pages already read by the server.
+ * Pure module: no network, no dependency.
+ */
+export interface SearchHit {
+    docId: string;
+    title: string;
+    url: string;
+    score: number;
+    snippet: string;
+}
+/** Lowercased tokens; dotted/dashed keys (spring.datasource.url) are kept whole and also split. */
+export declare function tokenize(text: string): string[];
+export declare class SearchIndex {
+    private readonly maxChars;
+    private readonly docs;
+    private readonly df;
+    private totalLength;
+    private totalChars;
+    constructor(opts?: {
+        maxChars?: number;
+    });
+    get size(): number;
+    has(docId: string): boolean;
+    add(docId: string, doc: {
+        title: string;
+        url: string;
+        text: string;
+    }): void;
+    search(query: string, limit: number, filter?: (docId: string) => boolean): SearchHit[];
+    private remove;
+}
+//# sourceMappingURL=search-index.d.ts.map

package/build/services/search-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-index.d.ts","sourceRoot":"","sources":["../../src/services/search-index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAyBD,mGAAmG;AACnG,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAY/C;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiC;IACtD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAA6B;IAChD,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,UAAU,CAAK;gBAEX,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO;IAI5C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI3B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IA4B3E,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,EAAE;IAgCtF,OAAO,CAAC,MAAM;CAYf"}

package/build/services/search-index.js

@@ -0,0 +1,147 @@
+/**
+ * In-memory BM25 full-text index over documentation pages already read by the server.
+ * Pure module: no network, no dependency.
+ */
+const K1 = 1.2;
+const B = 0.75;
+const TITLE_WEIGHT = 3;
+const DEFAULT_MAX_CHARS = 8_000_000;
+const SNIPPET_BEFORE = 80;
+const SNIPPET_AFTER = 120;
+const FALLBACK_SNIPPET = 200;
+const STOPWORDS = new Set([
+    "a", "an", "and", "are", "as", "at", "be", "by", "for", "from", "how", "in", "is", "it",
+    "of", "on", "or", "that", "the", "this", "to", "with", "what", "when", "which", "you", "your",
+]);
+const keep = (token) => token.length > 1 && !STOPWORDS.has(token);
+/** Lowercased tokens; dotted/dashed keys (spring.datasource.url) are kept whole and also split. */
+export function tokenize(text) {
+    const tokens = [];
+    for (const match of text.toLowerCase().matchAll(/[a-z0-9]+(?:[.-][a-z0-9]+)*/g)) {
+        const token = match[0];
+        if (keep(token))
+            tokens.push(token);
+        if (/[.-]/.test(token)) {
+            for (const part of token.split(/[.-]/)) {
+                if (keep(part))
+                    tokens.push(part);
+            }
+        }
+    }
+    return tokens;
+}
+export class SearchIndex {
+    maxChars;
+    docs = new Map();
+    df = new Map();
+    totalLength = 0;
+    totalChars = 0;
+    constructor(opts = {}) {
+        this.maxChars = opts.maxChars ?? DEFAULT_MAX_CHARS;
+    }
+    get size() {
+        return this.docs.size;
+    }
+    has(docId) {
+        return this.docs.has(docId);
+    }
+    add(docId, doc) {
+        this.remove(docId);
+        const text = doc.text.length > this.maxChars ? doc.text.slice(0, this.maxChars) : doc.text;
+        const tf = new Map();
+        let length = 0;
+        for (const token of tokenize(text)) {
+            tf.set(token, (tf.get(token) ?? 0) + 1);
+            length += 1;
+        }
+        for (const token of tokenize(doc.title)) {
+            tf.set(token, (tf.get(token) ?? 0) + TITLE_WEIGHT);
+            length += TITLE_WEIGHT;
+        }
+        for (const token of tf.keys()) {
+            this.df.set(token, (this.df.get(token) ?? 0) + 1);
+        }
+        this.docs.set(docId, { title: doc.title, url: doc.url, text, tf, length });
+        this.totalLength += length;
+        this.totalChars += text.length;
+        // Evict the oldest pages until the budget holds (the page just added is always last)
+        while (this.totalChars > this.maxChars && this.docs.size > 1) {
+            const oldest = this.docs.keys().next().value;
+            if (oldest === undefined)
+                break;
+            this.remove(oldest);
+        }
+    }
+    search(query, limit, filter) {
+        const terms = [...new Set(tokenize(query))];
+        if (terms.length === 0 || this.docs.size === 0)
+            return [];
+        const n = this.docs.size;
+        const avgLength = this.totalLength / n || 1;
+        const idf = new Map();
+        for (const term of terms) {
+            const df = this.df.get(term) ?? 0;
+            idf.set(term, Math.log(1 + (n - df + 0.5) / (df + 0.5)));
+        }
+        const scored = [];
+        for (const [docId, doc] of this.docs) {
+            if (filter && !filter(docId))
+                continue;
+            let score = 0;
+            for (const term of terms) {
+                const tf = doc.tf.get(term);
+                if (!tf)
+                    continue;
+                score += idf.get(term) * (tf * (K1 + 1)) / (tf + K1 * (1 - B + B * doc.length / avgLength));
+            }
+            if (score > 0)
+                scored.push({ docId, score });
+        }
+        scored.sort((x, y) => y.score - x.score || x.docId.localeCompare(y.docId));
+        const byIdf = [...terms].sort((x, y) => idf.get(y) - idf.get(x));
+        return scored.slice(0, limit).map(({ docId, score }) => {
+            const doc = this.docs.get(docId);
+            return { docId, title: doc.title, url: doc.url, score, snippet: makeSnippet(doc.text, byIdf) };
+        });
+    }
+    remove(docId) {
+        const doc = this.docs.get(docId);
+        if (!doc)
+            return;
+        for (const token of doc.tf.keys()) {
+            const next = (this.df.get(token) ?? 1) - 1;
+            if (next <= 0)
+                this.df.delete(token);
+            else
+                this.df.set(token, next);
+        }
+        this.totalLength -= doc.length;
+        this.totalChars -= doc.text.length;
+        this.docs.delete(docId);
+    }
+}
+/** ~200 characters around the best term, trimmed to whole words. */
+function makeSnippet(text, terms) {
+    const lower = text.toLowerCase();
+    for (const term of terms) {
+        const at = lower.indexOf(term);
+        if (at < 0)
+            continue;
+        let start = Math.max(0, at - SNIPPET_BEFORE);
+        let end = Math.min(text.length, at + SNIPPET_AFTER);
+        if (start > 0) {
+            const space = text.slice(start, at).search(/\s/);
+            if (space >= 0)
+                start += space + 1;
+        }
+        if (end < text.length) {
+            const space = text.slice(at, end).search(/\s\S*$/);
+            if (space >= 0)
+                end = at + space;
+        }
+        const body = text.slice(start, end).replace(/\s+/g, " ").trim();
+        return `${start > 0 ? "…" : ""}${body}${end < text.length ? "…" : ""}`;
+    }
+    return text.slice(0, FALLBACK_SNIPPET).replace(/\s+/g, " ").trim();
+}
+//# sourceMappingURL=search-index.js.map

package/build/services/search-index.js.map

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

package/build/services/spring-projects-config.d.ts

@@ -10,22 +10,34 @@
 export interface SpringProjectConfig {
     /** Unique project identifier (e.g., "boot", "ai", "security") */
     id: string;
+    /** GitHub repository (owner/name) hosting the releases */
+    githubRepo?: string;
+    /** Prefix of the release tag, e.g. "v" for v3.5.0 */
+    githubTagPrefix?: string;
     /** Human-readable display name (e.g., "Spring Boot", "Spring AI") */
     displayName: string;
-    /** Base URL for project documentation */
-    baseDocUrl: string;
-    /** Latest stable version (e.g., "3.5.6", "1.1.2") */
-    latestVersion: string;
-    /** Path to API documentation relative to baseDocUrl (optional) */
-    apiPath?: string;
     /** Whether documentation URLs include version in path */
     hasVersionedDocs: boolean;
     /** Cache TTL strategy: 'short' (30min) for frequently updated, 'long' (24h) for stable */
     cacheStrategy: 'short' | 'long';
-    /** Search keywords/scopes associated with this project */
-    scopes: string[];
     /** Reference documentation sections available for this project (optional) */
     referenceSections?: string[];
+    /** Base URL of the reference documentation (always the current version, no version in the path) */
+    referenceBaseUrl: string;
+    /**
+     * How a section maps to a page:
+     * 'directory' -> <base>/reference/<section>/index.html, 'flat' -> <base>/<section>.html
+     */
+    referenceLayout: 'directory' | 'flat';
+    /**
+     * Sections living outside the standard layout, as a path relative to the docs root (directory layout only).
+     * Limitation: in the 'directory' layout a subsection only reaches <dir>/<subsection>.html. A subsection that
+     * is itself a folder (e.g. oauth2/login/..., authentication/passwords/...) is not reachable, which is why
+     * such top-level sections are exposed through referencePaths instead.
+     */
+    referencePaths?: Record<string, string>;
+    /** Prefix of the unversioned reference URL after which "<version>/" is inserted to pin a documentation version */
+    versionInsertAfter?: string;
 }
 /**
  * Spring Projects Registry
@@ -48,10 +60,6 @@ export declare class SpringProjectsConfig {
      * @throws Error if project not found
      */
     getProject(projectId: string): SpringProjectConfig;
-    /**
-     * Check if a project is supported
-     */
-    hasProject(projectId: string): boolean;
     /**
      * Get all supported project IDs
      */
@@ -61,30 +69,15 @@ export declare class SpringProjectsConfig {
      */
     getAllProjects(): SpringProjectConfig[];
     /**
-     * Build documentation reference URL for a project
+     * Build documentation reference URL for a project (current documentation version)
      *
      * @param projectId - Project identifier
-     * @param section - Documentation section (e.g., "web", "chatclient")
-     * @param version - Optional version override (defaults to latest)
-     * @returns Complete URL to documentation section
-     */
-    buildReferenceUrl(projectId: string, section: string, version?: string): string;
-    /**
-     * Build API documentation URL for a project
-     *
-     * @param projectId - Project identifier
-     * @param version - Optional version override (defaults to latest)
-     * @returns Complete URL to API documentation
-     */
-    buildApiUrl(projectId: string, version?: string): string;
-    /**
-     * Find projects by scope/keyword
-     * Useful for routing queries to appropriate projects
-     *
-     * @param scope - Search scope keyword (e.g., "ai", "boot", "security")
-     * @returns Array of matching project configurations
+     * @param section - Documentation section (e.g., "web", "chatclient"), already validated as a safe URL segment
+     * @param subsection - Optional page inside the section (e.g., "servlet" for boot/web)
+     * @param version - Optional documentation version ("3.4" or "3.4.2"); omitted or "current" means the current docs
+     * @returns Complete URL to the documentation page
      */
-    findProjectsByScope(scope: string): SpringProjectConfig[];
+    buildReferenceUrl(projectId: string, section: string, subsection?: string, version?: string): string;
     /**
      * Get cache TTL in milliseconds for a project
      *

package/build/services/spring-projects-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spring-projects-config.d.ts","sourceRoot":"","sources":["../../src/services/spring-projects-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,mBAAmB;IAClC,iEAAiE;IACjE,EAAE,EAAE,MAAM,CAAC;IAEX,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;IAEpB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IAEnB,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;IAEtB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,yDAAyD;IACzD,gBAAgB,EAAE,OAAO,CAAC;IAE1B,0FAA0F;IAC1F,aAAa,EAAE,OAAO,GAAG,MAAM,CAAC;IAEhC,0DAA0D;IAC1D,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB,6EAA6E;IAC7E,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAsF3D,CAAC;AAEH;;;;;GAKG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;gBAEhD,WAAW,GAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAmB;IAI3E;;;OAGG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB;IAWlD;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAItC;;OAEG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAI5B;;OAEG;IACH,cAAc,IAAI,mBAAmB,EAAE;IAIvC;;;;;;;OAOG;IACH,iBAAiB,CACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,MAAM;IAWT;;;;;;OAMG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAgBxD;;;;;;OAMG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,EAAE;IAOzD;;;;;OAKG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IActC;;;OAGG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;CAU7D;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,sBAA6B,CAAC"}
+{"version":3,"file":"spring-projects-config.d.ts","sourceRoot":"","sources":["../../src/services/spring-projects-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,mBAAmB;IAClC,iEAAiE;IACjE,EAAE,EAAE,MAAM,CAAC;IAEX,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,qDAAqD;IACrD,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;IAEpB,yDAAyD;IACzD,gBAAgB,EAAE,OAAO,CAAC;IAE1B,0FAA0F;IAC1F,aAAa,EAAE,OAAO,GAAG,MAAM,CAAC;IAEhC,6EAA6E;IAC7E,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE7B,mGAAmG;IACnG,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,eAAe,EAAE,WAAW,GAAG,MAAM,CAAC;IAEtC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAExC,kHAAkH;IAClH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAqR3D,CAAC;AAEH;;;;;GAKG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;gBAEhD,WAAW,GAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAmB;IAI3E;;;OAGG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB;IAWlD;;OAEG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAI5B;;OAEG;IACH,cAAc,IAAI,mBAAmB,EAAE;IAIvC;;;;;;;;OAQG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAwBpG;;;;;OAKG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IActC;;;OAGG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;CAU7D;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,sBAA6B,CAAC"}