@adaptabletools/adaptable-mcp 0.1.0-canary.0 → 0.1.0-canary.2

package/dist/core/changes/grep.js

@@ -0,0 +1,183 @@
+/**
+ * The literal token search of `changes --repo` (plan §8.10), ported from the
+ * upgrade skill's `scan-usages.mjs`: a plain, case-sensitive substring search
+ * over the project's text files — `git ls-files` (tracked + untracked, honouring
+ * `.gitignore`) when the folder is a repository, a walk otherwise — with
+ * `node_modules`, dot-folders, build output, lockfiles, binaries, files over
+ * 2 MB and installed skill folders excluded. No code analysis; `file:line` hits
+ * per record, capped.
+ */
+import { execFileSync } from 'node:child_process';
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, relative, resolve, sep } from 'node:path';
+const IGNORED_DIRS = new Set(['node_modules', 'dist', 'build', 'out', 'coverage', 'tmp', 'bower_components']);
+/** Dot-folders hold tool configuration and installed agent skills, never application code */
+const isIgnoredDir = (name) => IGNORED_DIRS.has(name) || name.startsWith('.');
+const IGNORED_FILES = new Set(['package-lock.json', 'yarn.lock', 'pnpm-lock.yaml', 'bun.lockb', 'skills-lock.json']);
+/** The upgrade skill's own outputs; a resumed run must not match them */
+const isIgnoredFile = (name) => IGNORED_FILES.has(name) || /^ADAPTABLE_(UPGRADE|UPDATE)_.*\.md$/.test(name);
+const SKILL_MARKER = 'SKILL.md';
+export const MAX_FILE_BYTES = 2 * 1024 * 1024;
+/** Hits kept per record (plan §2 principle 8: grep hits capped per record) */
+export const MAX_MATCHES_PER_RECORD = 20;
+const BINARY_EXTENSIONS = new Set([
+    '.png', '.jpg', '.jpeg', '.gif', '.webp', '.ico', '.svg', '.pdf', '.zip', '.gz', '.tgz',
+    '.woff', '.woff2', '.ttf', '.eot', '.otf', '.mp4', '.mp3', '.wasm', '.map', '.lockb', '.xlsx', '.xls',
+]);
+function listFilesWithGit(root) {
+    try {
+        const out = execFileSync('git', ['-C', root, 'ls-files', '--cached', '--others', '--exclude-standard', '-z'], {
+            encoding: 'utf8',
+            maxBuffer: 256 * 1024 * 1024,
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        return out
+            .split('\0')
+            .filter(Boolean)
+            .map((p) => join(root, p))
+            .filter((p) => !relative(root, p).split(sep).slice(0, -1).some(isIgnoredDir));
+    }
+    catch {
+        return undefined;
+    }
+}
+function listFilesByWalking(root) {
+    const files = [];
+    const stack = [root];
+    while (stack.length) {
+        const dir = stack.pop();
+        let dirents;
+        try {
+            dirents = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const dirent of dirents) {
+            if (dirent.isDirectory()) {
+                if (!isIgnoredDir(dirent.name)) {
+                    stack.push(join(dir, dirent.name));
+                }
+            }
+            else if (dirent.isFile()) {
+                files.push(join(dir, dirent.name));
+            }
+        }
+    }
+    return files;
+}
+function isScannable(path) {
+    const name = path.slice(path.lastIndexOf(sep) + 1);
+    if (isIgnoredFile(name)) {
+        return false;
+    }
+    const dot = name.lastIndexOf('.');
+    const ext = dot >= 0 ? name.slice(dot).toLowerCase() : '';
+    if (BINARY_EXTENSIONS.has(ext)) {
+        return false;
+    }
+    try {
+        const size = statSync(path).size;
+        return size > 0 && size <= MAX_FILE_BYTES;
+    }
+    catch {
+        return false;
+    }
+}
+/** Drops every file inside a folder holding a `SKILL.md`: an installed agent skill, not application code */
+function excludeSkillFolders(files) {
+    const skillDirs = files.filter((p) => p.endsWith(sep + SKILL_MARKER)).map((p) => p.slice(0, p.lastIndexOf(sep) + 1));
+    return skillDirs.length ? files.filter((p) => !skillDirs.some((dir) => p.startsWith(dir))) : files;
+}
+/** The text files of a project worth searching */
+export function listProjectFiles(root) {
+    const absolute = resolve(root);
+    const files = listFilesWithGit(absolute) ?? listFilesByWalking(absolute);
+    return excludeSkillFolders(files).filter(isScannable);
+}
+const IDENTIFIER_TOKEN = /^[A-Za-z_$][\w$]*$/;
+const IDENTIFIER_CHAR = /[\w$]/;
+/**
+ * Whether `line` contains `token`: a plain substring, except that an identifier-shaped
+ * token (`AlertDefinition`, `predicateOptions`) must not be glued to other identifier
+ * characters — `AlertDefinitions:` is not a hit for `AlertDefinition`, while
+ * `predicateOptions.caseSensitive` and `predicateOptions:` are hits for `predicateOptions`.
+ */
+export function lineHas(line, token) {
+    if (!IDENTIFIER_TOKEN.test(token)) {
+        return line.includes(token);
+    }
+    let from = 0;
+    for (;;) {
+        const at = line.indexOf(token, from);
+        if (at < 0) {
+            return false;
+        }
+        const before = at > 0 ? line[at - 1] : '';
+        const after = line[at + token.length] ?? '';
+        if (!IDENTIFIER_CHAR.test(before) && !IDENTIFIER_CHAR.test(after)) {
+            return true;
+        }
+        from = at + 1;
+    }
+}
+/** Searches `projects` for every record's tokens; one pass per file, one `includes` per token */
+export function scanProjects(projects, records, options = {}) {
+    const cap = options.maxMatches ?? MAX_MATCHES_PER_RECORD;
+    const tokenIndex = new Map();
+    for (const record of records) {
+        for (const token of record.search) {
+            const ids = tokenIndex.get(token) ?? [];
+            if (!ids.includes(record.id)) {
+                ids.push(record.id);
+            }
+            tokenIndex.set(token, ids);
+        }
+    }
+    const tokens = [...tokenIndex.keys()];
+    const hits = new Map(); // id → "file:line" → match
+    let scannedFiles = 0;
+    for (const project of projects) {
+        const base = resolve(options.cwd ?? project);
+        for (const file of listProjectFiles(project)) {
+            let text;
+            try {
+                text = readFileSync(file, 'utf8');
+            }
+            catch {
+                continue;
+            }
+            if (text.includes('\0')) {
+                continue;
+            }
+            scannedFiles++;
+            const present = tokens.filter((token) => text.includes(token));
+            if (!present.length) {
+                continue;
+            }
+            const rel = relative(base, file) || file;
+            text.split(/\r?\n/).forEach((line, i) => {
+                for (const token of present) {
+                    if (!lineHas(line, token)) {
+                        continue;
+                    }
+                    for (const id of tokenIndex.get(token)) {
+                        const perRecord = hits.get(id) ?? new Map();
+                        const key = `${rel}:${i + 1}`;
+                        if (!perRecord.has(key)) {
+                            perRecord.set(key, { file: rel, line: i + 1, token });
+                        }
+                        hits.set(id, perRecord);
+                    }
+                }
+            });
+        }
+    }
+    const byRecord = new Map();
+    for (const [id, perRecord] of hits) {
+        const sorted = [...perRecord.values()].sort((a, b) => (a.file === b.file ? a.line - b.line : a.file.localeCompare(b.file)));
+        byRecord.set(id, { matches: sorted.slice(0, cap), total: sorted.length });
+    }
+    return { scannedFiles, byRecord };
+}
+//# sourceMappingURL=grep.js.map

package/dist/core/changes/grep.js.map

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

package/dist/core/changes/records.js

@@ -0,0 +1,172 @@
+/**
+ * Change records (plan §12, Appendix B) at run time: the bundled copies in
+ * `data/changes/<k-1>-<k>.json` (built by `scripts/build-records.ts` from the
+ * release notes and shipped with the package) and the hosted copies the docs
+ * build publishes at `llms/changes/<k-1>-<k>.json`, preferred when the hash the
+ * manifest lists for them differs from the bundled copy's (plan §12.3, §8.10) —
+ * so a release-note correction reaches users without a CLI publish. Also the
+ * `KeyRename` list the did-you-mean of `check state` / `check setup` reads from
+ * the `state` / `options` records (A2.2's hand-off).
+ */
+import { createHash } from 'node:crypto';
+import { existsSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { getManifestInfo } from '../compat/manifest.js';
+import { RECORDS_FLOOR } from '../constants.js';
+import { DOCS_DIR, getCacheDir } from '../packages/cache.js';
+export const AREAS = ['packages', 'css', 'state', 'aql', 'options', 'api', 'objects', 'deployment'];
+const BUNDLED_DIR = fileURLToPath(new URL('../../../data/changes/', import.meta.url));
+/** `files` key under which the docs build lists a transition's records (C3.1 follows this) */
+export const manifestKeyFor = (from, to) => `changes-${from}-${to}`;
+const sha256 = (text) => createHash('sha256').update(text).digest('hex');
+/** The bundled records of one transition, when the package ships them */
+export function readBundledRecords(from, to, dir = BUNDLED_DIR) {
+    const path = join(dir, `${from}-${to}.json`);
+    if (!existsSync(path)) {
+        return undefined;
+    }
+    const text = readFileSync(path, 'utf8');
+    return { file: JSON.parse(text), text };
+}
+/** Transitions with a bundled copy, oldest first */
+export function bundledTransitions(dir = BUNDLED_DIR) {
+    if (!existsSync(dir)) {
+        return [];
+    }
+    return readdirSync(dir)
+        .map((name) => /^(\d+)-(\d+)\.json$/.exec(name))
+        .filter((m) => !!m)
+        .map((m) => ({ from: Number(m[1]), to: Number(m[2]) }))
+        .sort((a, b) => a.to - b.to);
+}
+function hostedCachePath(host, from, to, hash) {
+    return join(getCacheDir(DOCS_DIR, new URL(host).hostname, 'changes'), `${from}-${to}.${hash.slice(0, 12)}.json`);
+}
+async function defaultFetchText(url) {
+    const response = await fetch(url, { signal: AbortSignal.timeout(30_000) });
+    return response.ok ? response.text() : undefined;
+}
+/**
+ * The records for every transition in `(from, to]`: hosted when the manifest lists a
+ * copy whose hash differs from the bundled one (fetched once per hash into the cache),
+ * else bundled. Never throws for a missing transition — `missing` says which.
+ */
+export async function loadRecords(options) {
+    const warnings = [];
+    const transitions = [];
+    const missing = [];
+    let manifest;
+    try {
+        manifest = await (options.manifest ?? (() => getManifestInfo({ offline: options.offline, docsHost: options.docsHost, maxAgeMs: options.maxAgeMs })))();
+    }
+    catch {
+        manifest = undefined;
+    }
+    const files = manifest?.manifest.files;
+    const host = manifest?.host;
+    const fetchText = options.fetchText ?? defaultFetchText;
+    for (let k = options.from + 1; k <= options.to; k++) {
+        const from = k - 1;
+        const bundled = readBundledRecords(from, k);
+        const hosted = files?.[manifestKeyFor(from, k)];
+        let loaded;
+        if (hosted && host && (!bundled || sha256(bundled.text) !== hosted.sha256)) {
+            const cached = hostedCachePath(host, from, k, hosted.sha256);
+            let text;
+            if (existsSync(cached)) {
+                text = readFileSync(cached, 'utf8');
+            }
+            else if (options.offline) {
+                warnings.push(`The docs host has newer change records for ${from} → ${k} than the bundled copy; --offline kept the bundled one.`);
+            }
+            else {
+                try {
+                    text = await fetchText(`${host}${hosted.path}`);
+                }
+                catch {
+                    text = undefined;
+                }
+                if (text === undefined) {
+                    warnings.push(`The hosted change records for ${from} → ${k} (${host}${hosted.path}) could not be fetched; the bundled copy was used.`);
+                }
+                else if (sha256(text) !== hosted.sha256) {
+                    warnings.push(`The hosted change records for ${from} → ${k} do not match the hash the manifest lists; the bundled copy was used.`);
+                    text = undefined;
+                }
+                else {
+                    writeFileSync(cached, text);
+                }
+            }
+            if (text !== undefined) {
+                loaded = { from, to: k, source: 'hosted', file: JSON.parse(text) };
+            }
+        }
+        if (!loaded && bundled) {
+            loaded = { from, to: k, source: 'bundled', file: bundled.file };
+        }
+        if (loaded) {
+            transitions.push(loaded);
+        }
+        else {
+            missing.push({ from, to: k });
+        }
+    }
+    return { transitions, missing, warnings };
+}
+const IDENTIFIER_PATH = /^[A-Za-z_$][\w$]*(\.[A-Za-z_$][\w$]*)*$/;
+const USE_IDENTIFIER = /^(?:removed\s*[—–-]\s*)?use\s+([A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)*)$/;
+/** Single words that read as identifiers but are prose or types in an `after` cell */
+const NOT_A_RENAME = new Set([
+    'removed', 'deprecated', 'gone', 'none', 'same', 'unchanged', 'inferred', 'required', 'optional', 'ignored', 'yes', 'no',
+    'string', 'number', 'boolean', 'object', 'function', 'any', 'void', 'never', 'null', 'undefined', 'true', 'false',
+    'Partial', 'Promise', 'Record', 'Array', 'unknown',
+]);
+/** The identifier path an `after` cell names: `a.b`, `a.b (note)`, `removed — use a.b`; `undefined` for prose */
+export function identifierOf(cell) {
+    const text = cell.replace(/\s*\([^)]*\)\s*$/, '').trim();
+    const found = IDENTIFIER_PATH.test(text) ? text : USE_IDENTIFIER.exec(text)?.[1];
+    return found && !NOT_A_RENAME.has(found) ? found : undefined;
+}
+/**
+ * Renames the did-you-mean can offer, from the `state` / `options` records: rows whose
+ * `before` is a dotted identifier and whose `after` names one (`a.b`, `a.b (note)`,
+ * `removed — use a.b`) with a different last segment —
+ * `predicateOptions.caseSensitivePredicates` → `expressionOptions.caseSensitiveExpressions`
+ * gives `caseSensitivePredicates` → `caseSensitiveExpressions`. No path prefix: the notes
+ * write paths loosely (`CalculatedColumn.Query`), so the rename applies at any position.
+ */
+export function keyRenames(file) {
+    const out = [];
+    const transition = `${file.from}-${file.to}`;
+    for (const record of file.records) {
+        if (record.area !== 'state' && record.area !== 'options') {
+            continue;
+        }
+        for (const row of record.rows) {
+            const after = identifierOf(row.after);
+            if (!IDENTIFIER_PATH.test(row.before) || !after) {
+                continue;
+            }
+            const from = row.before.split('.').pop();
+            const to = after.split('.').pop();
+            if (from === to || out.some((r) => r.from === from && r.to === to && r.area === record.area)) {
+                continue;
+            }
+            out.push({ from, to, area: record.area, transition, anchor: record.id });
+        }
+    }
+    return out;
+}
+const renamesByMajor = new Map();
+/** The renames that lead to `major`'s spellings, from the bundled records of `(major-1) → major`; `[]` when none are bundled */
+export function bundledRenamesFor(major) {
+    let renames = renamesByMajor.get(major);
+    if (!renames) {
+        const bundled = major > RECORDS_FLOOR ? readBundledRecords(major - 1, major) : undefined;
+        renames = bundled ? keyRenames(bundled.file) : [];
+        renamesByMajor.set(major, renames);
+    }
+    return renames;
+}
+//# sourceMappingURL=records.js.map

package/dist/core/changes/records.js.map

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

package/dist/core/changes/render-md.js

@@ -0,0 +1,101 @@
+/** Plan §8.10 section order (`packages` and `css` share the first) */
+export const AREA_ORDER = [
+    { title: 'Packages & CSS', areas: ['packages', 'css'] },
+    { title: 'Adaptable State', areas: ['state'] },
+    { title: 'Adaptable Options', areas: ['options'] },
+    { title: 'Adaptable API', areas: ['api'] },
+    { title: 'Adaptable Objects', areas: ['objects'] },
+    { title: 'AdapTableQL', areas: ['aql'] },
+    { title: 'Deployment', areas: ['deployment'] },
+];
+function autoMigratedOf(record) {
+    const values = [...new Set(record.rows.map((r) => r.autoMigrated))].filter((v) => v !== 'n/a');
+    return values.length ? values.join(' / ') : 'n/a';
+}
+const code = (text) => (text.includes('`') ? text : `\`${text}\``);
+export function renderRecord(record) {
+    const lines = [`#### ${record.title}`, '', `- **${record.type}** · auto-migrated: ${autoMigratedOf(record)} · id \`${record.id}\``];
+    for (const row of record.rows) {
+        const label = row.item && row.item !== record.title ? `${row.item}: ` : '';
+        lines.push(`- ${label}${code(row.before)} → ${code(row.after)}${record.rows.length > 1 && row.autoMigrated !== 'n/a' ? ` _(auto-migrated: ${row.autoMigrated})_` : ''}`);
+    }
+    if (record.note) {
+        lines.push(`- Note: ${record.note}`);
+    }
+    lines.push(`- Release note: ${record.url}`);
+    if (record.matches) {
+        if (record.matches.length) {
+            const more = (record.matchCount ?? record.matches.length) - record.matches.length;
+            lines.push(`- Matches: ${record.matches.map((m) => `\`${m.file}:${m.line}\``).join(', ')}${more > 0 ? ` … and ${more} more` : ''}`);
+        }
+        else if (record.always) {
+            lines.push('- Matches: (applies to every project)');
+        }
+        else if (!record.search.length) {
+            lines.push('- Matches: (no search tokens; review by hand)');
+        }
+        else {
+            lines.push('- Matches: none');
+        }
+    }
+    if (record.docsSection) {
+        lines.push('', ...record.docsSection.split('\n').map((l) => (l ? `> ${l}` : '>')));
+    }
+    lines.push('');
+    return lines;
+}
+export function renderTransition(transition, filtered) {
+    const lines = [`## AdapTable ${transition.from} → ${transition.to}`, '', `_Records ${transition.recordsSource}; release note: ${transition.releaseNote}_`, ''];
+    const included = transition.records.filter((r) => r.included);
+    for (const { title, areas } of AREA_ORDER) {
+        const records = included.filter((r) => areas.includes(r.area));
+        if (!records.length) {
+            continue;
+        }
+        lines.push(`### ${title}`, '');
+        for (const record of records) {
+            lines.push(...renderRecord(record));
+        }
+    }
+    if (!included.length) {
+        lines.push('_Nothing to do for this step._', '');
+    }
+    const excluded = transition.records.filter((r) => !r.included);
+    if (filtered && excluded.length) {
+        lines.push('<details><summary>Not matched in the project (' + excluded.length + ')</summary>', '');
+        for (const record of excluded) {
+            lines.push(`- ${record.type} [${record.area}] ${record.title} — ${record.url}`);
+        }
+        lines.push('', '</details>', '');
+    }
+    return lines;
+}
+export function renderChanges(data) {
+    const lines = [`# Changes ${data.from} → ${data.to}`, ''];
+    if (data.environment) {
+        const env = Object.entries(data.environment)
+            .filter(([, v]) => v)
+            .map(([k, v]) => `${k} ${v}`);
+        lines.push(`- Environment for ${data.to}: ${env.join(' · ')}`);
+    }
+    if (data.scanned) {
+        lines.push(`- Searched ${data.scanned.files} files in ${data.scanned.projects.join(', ')}${data.filtered ? '' : ' (every record listed, --all)'}`);
+    }
+    else {
+        lines.push('- No project searched: every record listed. Pass `--repo <dir>` to keep only the ones your code hits.');
+    }
+    lines.push('');
+    for (let k = data.from + 1; k <= data.to; k++) {
+        const transition = data.transitions.find((t) => t.to === k);
+        if (transition) {
+            lines.push(...renderTransition(transition, data.filtered));
+            continue;
+        }
+        const m = data.missing.find((x) => x.to === k);
+        if (m) {
+            lines.push(`## AdapTable ${m.from} → ${m.to}`, '', `_No change records yet; read ${m.releaseNote} by hand._`, '');
+        }
+    }
+    return lines.join('\n').trimEnd();
+}
+//# sourceMappingURL=render-md.js.map

package/dist/core/changes/render-md.js.map

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

package/dist/core/changes/with-docs.js

@@ -0,0 +1,86 @@
+/**
+ * `changes --with-docs` (plan §8.10): the release-note section each kept record
+ * links into, read through the docs corpus (the same path as `docs get`) and
+ * inlined under the record — collapsed to its heading when longer than
+ * `MAX_INLINE_LINES`. The `.md` export strips the `<Change>` anchors, so a
+ * record's section is its area's `###` heading inside `## Upgrade Guide`
+ * (the guide's intro for `deployment` records); one corpus and one page per
+ * transition, one extraction per area.
+ */
+import { loadCorpus } from '../docs/cache.js';
+import { extractHeading, findPage } from '../docs/get-page.js';
+import { CapabilityError } from '../envelope.js';
+export const MAX_INLINE_LINES = 60;
+/** The `###` heading of each area inside `## Upgrade Guide` (the same titles `build-records.ts` reads) */
+export const AREA_HEADINGS = {
+    packages: 'Packages & CSS',
+    css: 'Packages & CSS',
+    aql: 'AdapTableQL',
+    state: 'Adaptable State',
+    options: 'Adaptable Options',
+    api: 'Adaptable API',
+    objects: 'Adaptable Objects',
+};
+/** The guide's intro: everything before its first `###` */
+function guideIntro(guide) {
+    const lines = guide.split('\n');
+    const first = lines.findIndex((l, i) => i > 0 && /^###\s/.test(l));
+    return (first < 0 ? lines : lines.slice(0, first)).join('\n').trimEnd();
+}
+export function collapse(section, slug, heading) {
+    const lines = section.split('\n');
+    if (lines.length <= MAX_INLINE_LINES) {
+        return section;
+    }
+    return `${lines[0]}\n\n_${lines.length} lines — read it with \`adaptable docs get ${slug} --section "${heading}"\`._`;
+}
+/** Fills `docsSection` on every included record; returns warnings for what could not be read */
+export async function inlineSections(transitions, options) {
+    const warnings = [];
+    for (const transition of transitions) {
+        const slug = `support/version-${transition.to}0-release-note`;
+        let guide;
+        try {
+            const { corpus, warnings: corpusWarnings } = await loadCorpus({ major: transition.to, ...options });
+            warnings.push(...corpusWarnings);
+            const page = findPage(corpus, `/${slug}`);
+            if (!page) {
+                warnings.push(`--with-docs: ${slug} is not in the docs corpus of ${corpus.host}; sections not inlined for ${transition.from} → ${transition.to}.`);
+                continue;
+            }
+            guide = extractHeading(page.markdown, 'Upgrade Guide');
+            if (!guide) {
+                warnings.push(`--with-docs: ${slug} has no "Upgrade Guide" heading; sections not inlined for ${transition.from} → ${transition.to}.`);
+                continue;
+            }
+        }
+        catch (error) {
+            if (error instanceof CapabilityError) {
+                warnings.push(`--with-docs: ${error.message} Sections not inlined for ${transition.from} → ${transition.to}.`);
+                continue;
+            }
+            throw error;
+        }
+        const sections = new Map();
+        for (const record of transition.records) {
+            if (!record.included) {
+                continue;
+            }
+            const heading = record.area === 'deployment' ? undefined : AREA_HEADINGS[record.area];
+            const key = heading ?? '(intro)';
+            if (!sections.has(key)) {
+                const section = heading ? extractHeading(guide, heading) : guideIntro(guide);
+                sections.set(key, section ? collapse(section, slug, heading ?? 'Upgrade Guide') : undefined);
+                if (!section) {
+                    warnings.push(`--with-docs: no "${heading}" section under the Upgrade Guide of ${slug}.`);
+                }
+            }
+            const section = sections.get(key);
+            if (section) {
+                record.docsSection = section;
+            }
+        }
+    }
+    return warnings;
+}
+//# sourceMappingURL=with-docs.js.map

package/dist/core/changes/with-docs.js.map

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