@enokdev/springdocs-mcp 1.2.7 → 1.4.1

package/build/services/http.js

@@ -0,0 +1,168 @@
+import fetch from 'node-fetch';
+import { USER_AGENT } from '../version.js';
+const GITHUB_API_HOST = 'api.github.com';
+/** Optional GITHUB_TOKEN, trimmed; undefined when unset or blank. Never log it. */
+function githubToken() {
+    const token = process.env.GITHUB_TOKEN?.trim();
+    return token ? token : undefined;
+}
+/** Clear message for a GitHub rate-limited response (no waiting, no secret in it). */
+export function githubRateLimitMessage(rateLimit) {
+    let message = githubToken()
+        ? 'GitHub API rate limit reached (authenticated with GITHUB_TOKEN).'
+        : 'GitHub API rate limit reached (60 requests/hour without authentication; set GITHUB_TOKEN to raise it to 5000).';
+    if (rateLimit?.retryAfterSeconds !== undefined) {
+        message += ` Retry in ${rateLimit.retryAfterSeconds} seconds.`;
+    }
+    else if (rateLimit?.resetAt) {
+        message += ` The limit resets at ${rateLimit.resetAt}.`;
+    }
+    else {
+        message += ' Try again later.';
+    }
+    return message;
+}
+function parseRateLimit(headers) {
+    const retryAfter = Number(headers.get('retry-after') ?? NaN);
+    const remaining = headers.get('x-ratelimit-remaining');
+    const reset = Number(headers.get('x-ratelimit-reset') ?? NaN);
+    const hasRetryAfter = headers.get('retry-after') !== null && Number.isFinite(retryAfter) && retryAfter >= 0;
+    if (!hasRetryAfter && remaining !== '0')
+        return undefined;
+    const info = {};
+    if (hasRetryAfter)
+        info.retryAfterSeconds = retryAfter;
+    if (Number.isFinite(reset) && reset > 0)
+        info.resetAt = new Date(reset * 1000).toISOString();
+    return info;
+}
+export const REQUEST_TIMEOUT = 10000;
+export const MAX_RETRIES = 3;
+export const MAX_RESPONSE_BYTES = 5 * 1024 * 1024; // 5 MiB
+export const MAX_REDIRECTS = 5;
+export const ALLOWED_REDIRECT_HOSTS = new Set([
+    'docs.spring.io',
+    'spring.io',
+    'github.com',
+    'api.github.com',
+    'raw.githubusercontent.com'
+]);
+const REDIRECT_STATUSES = new Set([301, 302, 303, 307, 308]);
+class ResponseTooLargeError extends Error {
+    constructor(url) {
+        super(`Response from ${url} exceeds the 5 MiB limit`);
+    }
+}
+/** A refused redirect (host, protocol, loop, too many hops): never retried. */
+class RedirectError extends Error {
+}
+export async function fetchWithRetry(url, timeout = REQUEST_TIMEOUT, retries = MAX_RETRIES) {
+    for (let attempt = 1; attempt <= retries; attempt++) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        let delayMs = 1000 * 2 ** (attempt - 1); // Exponential backoff
+        try {
+            // Redirects are followed manually (always GET) so every hop can be checked
+            let currentUrl = url;
+            const visited = new Set([url]);
+            let redirects = 0;
+            let response;
+            for (;;) {
+                const headers = {
+                    'User-Agent': USER_AGENT,
+                    'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
+                    'Accept-Language': 'en-US,en;q=0.9'
+                };
+                // The token goes to api.github.com only, checked on every hop (never after a redirect elsewhere)
+                const token = githubToken();
+                if (token && new URL(currentUrl).hostname === GITHUB_API_HOST) {
+                    headers['Authorization'] = `Bearer ${token}`;
+                }
+                response = await fetch(currentUrl, {
+                    signal: controller.signal,
+                    size: MAX_RESPONSE_BYTES,
+                    redirect: 'manual',
+                    headers
+                });
+                // Reject early when the server announces a body above the limit
+                const declaredLength = Number(response.headers.get('content-length'));
+                if (Number.isFinite(declaredLength) && declaredLength > MAX_RESPONSE_BYTES) {
+                    throw new ResponseTooLargeError(currentUrl);
+                }
+                const location = REDIRECT_STATUSES.has(response.status) ? response.headers.get('location') : null;
+                if (!location)
+                    break; // not a followable redirect: returned as is
+                // The body of a redirect is useless: discard it without reading
+                response.body?.resume?.();
+                let next;
+                try {
+                    next = new URL(location, currentUrl);
+                }
+                catch {
+                    throw new RedirectError(`Invalid redirect Location from ${currentUrl}: ${location}`);
+                }
+                if (next.protocol !== 'https:') {
+                    throw new RedirectError(`Redirect to disallowed protocol ${next.protocol} from ${currentUrl}`);
+                }
+                if (!ALLOWED_REDIRECT_HOSTS.has(next.hostname)) {
+                    throw new RedirectError(`Redirect to disallowed host ${next.hostname} from ${currentUrl}`);
+                }
+                if (visited.has(next.href)) {
+                    throw new RedirectError(`Redirect loop detected at ${next.href}`);
+                }
+                if (++redirects > MAX_REDIRECTS) {
+                    throw new RedirectError(`Too many redirects (more than ${MAX_REDIRECTS}) starting from ${url}`);
+                }
+                visited.add(next.href);
+                currentUrl = next.href;
+            }
+            // Read the body before clearing the timeout so the timeout also covers it
+            let body;
+            try {
+                body = await response.text();
+            }
+            catch (error) {
+                // node-fetch aborts the read once `size` is exceeded
+                if (error.type === 'max-size')
+                    throw new ResponseTooLargeError(url);
+                throw error;
+            }
+            const result = {
+                ok: response.ok,
+                status: response.status,
+                text: async () => body,
+                json: async () => JSON.parse(body)
+            };
+            // A GitHub rate limit lasts minutes to an hour: waiting 10 s is pointless, report it at once
+            if ((response.status === 403 || response.status === 429) && new URL(currentUrl).hostname === GITHUB_API_HOST) {
+                const rateLimit = parseRateLimit(response.headers);
+                if (rateLimit) {
+                    result.rateLimit = rateLimit;
+                    return result;
+                }
+            }
+            const retryable = response.status === 429 || response.status >= 500;
+            if (!retryable || attempt === retries)
+                return result;
+            const retryAfterHeader = response.headers.get('retry-after');
+            const retryAfter = retryAfterHeader === null ? NaN : Number(retryAfterHeader);
+            if (Number.isFinite(retryAfter) && retryAfter >= 0) {
+                delayMs = Math.min(retryAfter * 1000, 10000);
+            }
+            console.error(`Retry ${attempt}/${retries} for ${url}: HTTP ${response.status}`);
+        }
+        catch (error) {
+            if (error instanceof ResponseTooLargeError || error instanceof RedirectError)
+                throw error; // never retried
+            if (attempt === retries)
+                throw error;
+            console.error(`Retry ${attempt}/${retries} for ${url}:`, error instanceof Error ? error.message : 'Unknown error');
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+        await new Promise(resolve => setTimeout(resolve, delayMs));
+    }
+    throw new Error('All retry attempts failed');
+}
+//# sourceMappingURL=http.js.map

package/build/services/http.js.map

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

package/build/services/initializr.d.ts

@@ -0,0 +1,41 @@
+import { CacheService } from './cache.js';
+import { BuildChoice } from './dependency-finder.js';
+interface OptionValue {
+    id: string;
+    name?: string;
+}
+interface OptionGroup {
+    default?: string;
+    values: OptionValue[];
+}
+interface Dependency {
+    id: string;
+    name: string;
+    description?: string;
+}
+interface DependencyGroup {
+    name: string;
+    values: Dependency[];
+}
+export interface InitializrMetadata {
+    type?: OptionGroup;
+    javaVersion?: OptionGroup;
+    language?: OptionGroup;
+    packaging?: OptionGroup;
+    bootVersion?: OptionGroup;
+    dependencies?: {
+        values: DependencyGroup[];
+    };
+}
+export declare function formatOptions(meta: InitializrMetadata): string;
+export declare function formatDependencies(meta: InitializrMetadata, query?: string): string;
+export declare class InitializrService {
+    private cache;
+    constructor(cache?: CacheService);
+    getInitializr(section?: 'options' | 'dependencies', query?: string): Promise<string>;
+    findDependency(need: string, build?: BuildChoice, bootVersion?: string): Promise<string>;
+    private loadCoordinates;
+    private loadMetadata;
+}
+export {};
+//# sourceMappingURL=initializr.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"initializr.d.ts","sourceRoot":"","sources":["../../src/services/initializr.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAwG,MAAM,wBAAwB,CAAC;AAY3J,UAAU,WAAW;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AACnD,UAAU,WAAW;IAAG,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE;AACjE,UAAU,UAAU;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE;AACvE,UAAU,eAAe;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,EAAE,CAAA;CAAE;AAEhE,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE;QAAE,MAAM,EAAE,eAAe,EAAE,CAAA;KAAE,CAAC;CAC9C;AAkBD,wBAAgB,aAAa,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAY9D;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CA+BnF;AAED,qBAAa,iBAAiB;IAChB,OAAO,CAAC,KAAK;gBAAL,KAAK,GAAE,YAAiC;IAEtD,aAAa,CAAC,OAAO,GAAE,SAAS,GAAG,cAA0B,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK/F,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,WAAoB,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAcxF,eAAe;YAiBf,YAAY;CAmB3B"}

package/build/services/initializr.js

@@ -0,0 +1,135 @@
+import { CacheService } from './cache.js';
+import { fetchWithRetry } from './http.js';
+import { escapeInline, flattenCatalog, formatDependencyMatches, rankDependencies, searchWords } from './dependency-finder.js';
+// Reads the Spring Initializr metadata (https://start.spring.io/metadata/client):
+// build options and the list of available dependencies. Real API only, no mock data.
+const METADATA_URL = 'https://start.spring.io/metadata/client';
+const CACHE_KEY = 'initializr:metadata';
+const COORDINATES_URL = 'https://start.spring.io/dependencies';
+const COORDINATES_CACHE_KEY = 'initializr:dependencies';
+const MAX_MATCHES = 30;
+const BOOT_VERSION = /^\d{1,3}\.\d{1,3}\.\d{1,3}$/;
+function unexpected(what) {
+    throw new Error(`Spring Initializr returned an unexpected response (missing ${what})`);
+}
+function optionLine(label, group) {
+    if (!group || !Array.isArray(group.values))
+        unexpected(label);
+    const items = group.values.map(v => {
+        const tags = [];
+        if (v.id === group.default)
+            tags.push('default');
+        if (/SNAPSHOT/i.test(v.id))
+            tags.push('snapshot');
+        else if (/[.-](M|RC)\d+/i.test(v.id))
+            tags.push('milestone');
+        return `\`${v.id}\`${tags.length ? ` (${tags.join(', ')})` : ''}`;
+    });
+    return `- **${label}**: ${items.join(', ')}`;
+}
+export function formatOptions(meta) {
+    return [
+        '# Spring Initializr options',
+        '',
+        optionLine('Build type', meta.type),
+        optionLine('Java version', meta.javaVersion),
+        optionLine('Language', meta.language),
+        optionLine('Packaging', meta.packaging),
+        optionLine('Spring Boot version', meta.bootVersion),
+        '',
+        'Source: https://start.spring.io — use `section: "dependencies"` to list the dependency ids.',
+    ].join('\n');
+}
+export function formatDependencies(meta, query) {
+    const groups = meta.dependencies?.values;
+    if (!Array.isArray(groups))
+        unexpected('dependencies');
+    const needle = query?.trim().toLowerCase();
+    if (!needle) {
+        const lines = ['# Spring Initializr dependencies', ''];
+        for (const group of groups) {
+            lines.push(`## ${group.name}`, '');
+            for (const dep of group.values)
+                lines.push(`- \`${dep.id}\` — ${dep.name}`);
+            lines.push('');
+        }
+        return lines.join('\n').trimEnd();
+    }
+    const matches = [];
+    for (const group of groups) {
+        for (const dep of group.values) {
+            const haystack = `${dep.id} ${dep.name} ${dep.description ?? ''}`.toLowerCase();
+            if (haystack.includes(needle))
+                matches.push(dep);
+        }
+    }
+    if (matches.length === 0)
+        return `No dependency matches "${escapeInline(query)}".`;
+    const shown = matches.slice(0, MAX_MATCHES);
+    const lines = [`# Spring Initializr dependencies matching "${escapeInline(query)}"`, ''];
+    for (const dep of shown)
+        lines.push(`- \`${dep.id}\` — ${dep.name}${dep.description ? `: ${dep.description}` : ''}`);
+    if (matches.length > shown.length) {
+        lines.push('', `${matches.length - shown.length} more matches, refine the query.`);
+    }
+    return lines.join('\n');
+}
+export class InitializrService {
+    cache;
+    constructor(cache = new CacheService()) {
+        this.cache = cache;
+    }
+    async getInitializr(section = 'options', query) {
+        const meta = await this.loadMetadata();
+        return section === 'dependencies' ? formatDependencies(meta, query) : formatOptions(meta);
+    }
+    async findDependency(need, build = 'both', bootVersion) {
+        const words = searchWords(need);
+        if (words.length === 0) {
+            throw new Error('The need must contain at least one searchable word (English keywords such as "jpa" or "oauth2")');
+        }
+        if (bootVersion !== undefined && !BOOT_VERSION.test(bootVersion)) {
+            throw new Error('The bootVersion must use the X.Y.Z format (for example "4.0.8")');
+        }
+        const meta = await this.loadMetadata();
+        const data = await this.loadCoordinates(bootVersion);
+        const ranked = rankDependencies(flattenCatalog(meta), words);
+        return formatDependencyMatches(need, ranked, data, build);
+    }
+    async loadCoordinates(bootVersion) {
+        const cacheKey = bootVersion ? `${COORDINATES_CACHE_KEY}:${bootVersion}` : COORDINATES_CACHE_KEY;
+        const cached = this.cache.get(cacheKey);
+        if (cached)
+            return cached;
+        const response = await fetchWithRetry(bootVersion ? `${COORDINATES_URL}?bootVersion=${bootVersion}` : COORDINATES_URL);
+        if (!response.ok) {
+            throw new Error(`Spring Initializr is unavailable (HTTP ${response.status})`);
+        }
+        const data = (await response.json());
+        if (!data || typeof data.dependencies !== 'object' || data.dependencies === null || Array.isArray(data.dependencies)) {
+            unexpected('dependencies');
+        }
+        this.cache.setLongTerm(cacheKey, data);
+        return data;
+    }
+    async loadMetadata() {
+        const cached = this.cache.get(CACHE_KEY);
+        if (cached)
+            return cached;
+        const response = await fetchWithRetry(METADATA_URL);
+        if (!response.ok) {
+            throw new Error(`Spring Initializr is unavailable (HTTP ${response.status})`);
+        }
+        const meta = (await response.json());
+        const optionsOk = meta && [meta.type, meta.javaVersion, meta.language, meta.packaging, meta.bootVersion]
+            .every(group => Array.isArray(group?.values));
+        const dependenciesOk = meta && Array.isArray(meta.dependencies?.values)
+            && meta.dependencies.values.every(group => Array.isArray(group?.values));
+        if (!optionsOk || !dependenciesOk) {
+            unexpected('options or dependencies');
+        }
+        this.cache.setLongTerm(CACHE_KEY, meta);
+        return meta;
+    }
+}
+//# sourceMappingURL=initializr.js.map

package/build/services/initializr.js.map

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

package/build/services/markdown.d.ts

@@ -0,0 +1,56 @@
+import TurndownService from 'turndown';
+export declare const turndownService: TurndownService;
+/** An open fenced code block: its fence character and the length of the opening fence. */
+export interface Fence {
+    char: '`' | '~';
+    length: number;
+}
+/**
+ * Fence state after `line`, given the state before it (null = outside a code block).
+ * An opening fence is 3+ backticks or tildes (a backtick fence cannot carry
+ * backticks in its info string); a closing fence uses the same character, is at
+ * least as long as the opening one and carries nothing but whitespace.
+ */
+export declare function advanceFence(state: Fence | null, line: string): Fence | null;
+/** The fence line that closes (or reopens) a block opened with `fence`. */
+export declare function fenceMarker(fence: Fence): string;
+export interface FenceLine {
+    /** Whether the line begins inside a fenced code block. */
+    inCode: boolean;
+    /** The open fence at the start of the line (null when outside a block). */
+    fence: Fence | null;
+    /** Whether the line is itself an opening or closing fence. */
+    isFence: boolean;
+    /** The open fence after this line (null when outside a block). */
+    after: Fence | null;
+}
+/** Code-fence state of every line, in one pass. Single source of truth for all fence tracking. */
+export declare function scanFences(lines: readonly string[]): FenceLine[];
+export declare const DETAIL_LIMITS: Record<string, number>;
+/**
+ * Keep the beginning of a markdown document within the detail level's budget.
+ * The cut happens on a line boundary; a code block cut in the middle is closed
+ * so the result stays valid markdown.
+ */
+export declare function extractContent(markdown: string, detailLevel?: string): {
+    content: string;
+    truncated: boolean;
+};
+export declare const PAGE_SIZE = 4000;
+/**
+ * Return one page of a markdown document starting at `offset`.
+ * The page ends at a clean boundary: before a heading, else after a blank line
+ * (both only outside code blocks and past the middle of the window), else on a
+ * line boundary, else a hard cut for a single huge line. A code block cut by the
+ * page boundary is closed here and reopened at the start of the next page.
+ * `start`/`end` are positions in the original markdown (`end` exclusive);
+ * `nextOffset` is `end` when content remains, else null.
+ */
+export declare function pageMarkdown(markdown: string, offset?: number, pageSize?: number): {
+    content: string;
+    start: number;
+    end: number;
+    nextOffset: number | null;
+    total: number;
+};
+//# sourceMappingURL=markdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/services/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,UAAU,CAAC;AAEvC,eAAO,MAAM,eAAe,iBAG1B,CAAC;AAEH,0FAA0F;AAC1F,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,GAAG,GAAG,GAAG,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAKD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAW5E;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAEhD;AAED,MAAM,WAAW,SAAS;IACxB,0DAA0D;IAC1D,MAAM,EAAE,OAAO,CAAC;IAChB,2EAA2E;IAC3E,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,8DAA8D;IAC9D,OAAO,EAAE,OAAO,CAAC;IACjB,kEAAkE;IAClE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,kGAAkG;AAClG,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAAE,CAOhE;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAIhD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAE,MAAiB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAyBxH;AAED,eAAO,MAAM,SAAS,OAAO,CAAC;AAsB9B;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,MAAU,EAClB,QAAQ,GAAE,MAAkB,GAC3B;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAuC3F"}

package/build/services/markdown.js

@@ -0,0 +1,146 @@
+import TurndownService from 'turndown';
+export const turndownService = new TurndownService({
+    headingStyle: 'atx',
+    codeBlockStyle: 'fenced',
+});
+const OPENING_FENCE = /^\s*(`{3,}|~{3,})(.*)$/;
+const CLOSING_FENCE = /^\s*(`{3,}|~{3,})\s*$/;
+/**
+ * Fence state after `line`, given the state before it (null = outside a code block).
+ * An opening fence is 3+ backticks or tildes (a backtick fence cannot carry
+ * backticks in its info string); a closing fence uses the same character, is at
+ * least as long as the opening one and carries nothing but whitespace.
+ */
+export function advanceFence(state, line) {
+    if (state) {
+        const close = CLOSING_FENCE.exec(line);
+        if (close && close[1][0] === state.char && close[1].length >= state.length)
+            return null;
+        return state;
+    }
+    const open = OPENING_FENCE.exec(line);
+    if (!open)
+        return null;
+    const char = open[1][0];
+    if (char === '`' && open[2].includes('`'))
+        return null;
+    return { char, length: open[1].length };
+}
+/** The fence line that closes (or reopens) a block opened with `fence`. */
+export function fenceMarker(fence) {
+    return fence.char.repeat(fence.length);
+}
+/** Code-fence state of every line, in one pass. Single source of truth for all fence tracking. */
+export function scanFences(lines) {
+    let state = null;
+    return lines.map((line) => {
+        const before = state;
+        state = advanceFence(before, line);
+        return { inCode: before !== null, fence: before, isFence: (before === null) !== (state === null), after: state };
+    });
+}
+export const DETAIL_LIMITS = {
+    summary: 1500,
+    medium: 4000,
+    full: 50000,
+};
+/**
+ * Keep the beginning of a markdown document within the detail level's budget.
+ * The cut happens on a line boundary; a code block cut in the middle is closed
+ * so the result stays valid markdown.
+ */
+export function extractContent(markdown, detailLevel = 'medium') {
+    const maxLength = DETAIL_LIMITS[detailLevel] ?? DETAIL_LIMITS.medium;
+    if (markdown.length <= maxLength)
+        return { content: markdown, truncated: false };
+    const kept = [];
+    let length = 0;
+    let fence = null;
+    for (const line of markdown.split('\n')) {
+        if (length + line.length + 1 > maxLength)
+            break;
+        kept.push(line);
+        length += line.length + 1;
+        fence = advanceFence(fence, line);
+    }
+    // A first line longer than the budget leaves nothing: hard-cut it instead
+    if (kept.length === 0) {
+        const firstLine = markdown.split('\n', 1)[0];
+        const open = advanceFence(null, firstLine);
+        const first = markdown.slice(0, maxLength);
+        return { content: open ? `${first}\n${fenceMarker(open)}` : first, truncated: true };
+    }
+    let content = kept.join('\n').trimEnd();
+    if (fence)
+        content += `\n${fenceMarker(fence)}`;
+    return { content, truncated: true };
+}
+export const PAGE_SIZE = 4000;
+/** Split into lines with their start position and code-fence state, in one pass. */
+function scanLines(markdown) {
+    const texts = [];
+    const starts = [];
+    let start = 0;
+    while (start < markdown.length) {
+        const newline = markdown.indexOf('\n', start);
+        const end = newline === -1 ? markdown.length : newline;
+        texts.push(markdown.slice(start, end));
+        starts.push(start);
+        start = end + 1;
+    }
+    return scanFences(texts).map((fence, i) => ({ ...fence, start: starts[i], text: texts[i] }));
+}
+/**
+ * Return one page of a markdown document starting at `offset`.
+ * The page ends at a clean boundary: before a heading, else after a blank line
+ * (both only outside code blocks and past the middle of the window), else on a
+ * line boundary, else a hard cut for a single huge line. A code block cut by the
+ * page boundary is closed here and reopened at the start of the next page.
+ * `start`/`end` are positions in the original markdown (`end` exclusive);
+ * `nextOffset` is `end` when content remains, else null.
+ */
+export function pageMarkdown(markdown, offset = 0, pageSize = PAGE_SIZE) {
+    const total = markdown.length;
+    if (offset >= total)
+        return { content: '', start: offset, end: offset, nextOffset: null, total };
+    const lines = scanLines(markdown);
+    // Fence state at a position = state at the start of the line containing it
+    const stateAt = (position) => {
+        let found = lines[0];
+        for (const line of lines) {
+            if (line.start > position)
+                break;
+            found = line;
+        }
+        return found.fence;
+    };
+    const startFence = stateAt(offset);
+    const windowEnd = Math.min(total, offset + pageSize);
+    let end = windowEnd;
+    if (windowEnd < total) {
+        let heading = -1;
+        let blank = -1;
+        let anyLine = -1;
+        lines.forEach((line, index) => {
+            // Candidate boundaries are line starts strictly after `offset`, within the window
+            if (line.start <= offset || line.start > windowEnd)
+                return;
+            anyLine = line.start;
+            if (line.inCode || line.start < offset + pageSize / 2)
+                return;
+            if (/^#{1,6}\s/.test(line.text))
+                heading = line.start;
+            else if (lines[index - 1].text === '')
+                blank = line.start;
+        });
+        end = heading !== -1 ? heading : blank !== -1 ? blank : anyLine !== -1 ? anyLine : windowEnd;
+    }
+    let content = markdown.slice(offset, end);
+    if (startFence)
+        content = `${fenceMarker(startFence)}\n${content}`;
+    const endFence = end < total ? stateAt(end) : null;
+    if (endFence)
+        content = content.replace(/\n?$/, `\n${fenceMarker(endFence)}`);
+    return { content, start: offset, end, nextOffset: end < total ? end : null, total };
+}
+//# sourceMappingURL=markdown.js.map

package/build/services/markdown.js.map

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

package/build/services/migration-sources.d.ts

@@ -0,0 +1,13 @@
+export type MigrationProject = 'spring-boot' | 'spring-framework' | 'spring-batch';
+export type RawMigrationDocument = 'migration-guide' | 'release-notes';
+export type RawMigrationProject = Exclude<MigrationProject, 'spring-boot'>;
+export declare const MIGRATION_PROJECTS: readonly MigrationProject[];
+export declare function isMigrationProject(value: string): value is MigrationProject;
+export declare function projectDisplayName(project: MigrationProject): string;
+export declare function rawWikiTitle(project: RawMigrationProject, version: string): string;
+export declare function rawWikiUrl(project: RawMigrationProject, version: string): string;
+/** `auto` and the project's only document resolve to it; the other one is rejected before any request. */
+export declare function resolveRawDocument(project: RawMigrationProject, document: 'auto' | RawMigrationDocument): RawMigrationDocument;
+/** A real page is markdown, never an HTML document (home page or error page). */
+export declare function assertRawMarkdown(body: string, title: string, url: string): string;
+//# sourceMappingURL=migration-sources.d.ts.map

package/build/services/migration-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-sources.d.ts","sourceRoot":"","sources":["../../src/services/migration-sources.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,kBAAkB,GAAG,cAAc,CAAC;AACnF,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,GAAG,eAAe,CAAC;AACvE,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC;AAE3E,eAAO,MAAM,kBAAkB,EAAE,SAAS,gBAAgB,EAAwD,CAAC;AAanH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,gBAAgB,CAE3E;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAEpE;AAID,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAGlF;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAIhF;AAED,0GAA0G;AAC1G,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,EAAE,MAAM,GAAG,oBAAoB,GACtC,oBAAoB,CAMtB;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAMlF"}