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

package/dist/core/aql/engine.js

@@ -0,0 +1,92 @@
+/**
+ * The engine package's `aql` entry (plan §7.3: any major ≥ 24, resolved
+ * independently of the project's own version), loaded once per location per
+ * process, plus the per-module capabilities it describes (S.1 export) with a
+ * bundled fallback for engines that predate it.
+ */
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { ENGINE_FLOOR } from '../constants.js';
+import { EXPRESSION_MODULES } from '../packages/entry-types.js';
+import { loadEntry, packageLocation, sourceOverride } from '../packages/load-entry.js';
+import { resolvePackage } from '../packages/resolve.js';
+import { majorOfVersion } from '../packages/versions.js';
+const loaded = new Map();
+/** The engine's `aql` entry, bundled and imported once per location per process */
+export function loadAql(location) {
+    const key = location.kind === 'source' ? `source:${location.dir}` : `package:${location.version}:${location.dir}`;
+    let pending = loaded.get(key);
+    if (!pending) {
+        pending = loadEntry(location, 'aql').then((result) => result.ok ? { ok: true, module: result.module } : { ok: false, reason: result.reason });
+        loaded.set(key, pending);
+    }
+    return pending;
+}
+/** Upper-cased aggregation names → call form, from the catalogue */
+export function aggregationsOf(aql) {
+    return new Map(aql
+        .getExpressionFunctionCatalogue()
+        .filter((f) => f.group === 'aggregation')
+        .map((f) => [f.name.toUpperCase(), f.callForm]));
+}
+/** Resolves and loads the engine; `PACKAGE_REQUIRED` propagates (plan §7.3 step 4), a broken entry throws */
+export async function resolveEngine(deps) {
+    const override = sourceOverride();
+    const resolved = override ? undefined : await resolvePackage({ kind: 'engine' }, deps);
+    const location = override ?? packageLocation(resolved);
+    const result = await loadAql(location);
+    if (!result.ok) {
+        throw new Error(result.reason);
+    }
+    return {
+        module: result.module,
+        aggregations: aggregationsOf(result.module),
+        location,
+        ...(resolved ? { resolved } : {}),
+        label: resolved ? `${resolved.version} (${resolved.source})` : `source@${location.dir}`,
+    };
+}
+export const supportsAql = (major) => major >= ENGINE_FLOOR;
+/**
+ * The engine's own major: the package version, or — under the source override, whose
+ * `package.json` carries a placeholder version until the build stamps it — the
+ * floor, as the library's own `getCurrentMajorVersion()` falls back to.
+ */
+export function engineMajor(engine) {
+    if (engine.resolved) {
+        return majorOfVersion(engine.resolved.version) ?? ENGINE_FLOOR;
+    }
+    try {
+        const { version } = JSON.parse(readFileSync(join(engine.location.dir, 'package.json'), 'utf8'));
+        const major = version ? majorOfVersion(version) : undefined;
+        return major !== undefined && major >= ENGINE_FLOOR ? major : ENGINE_FLOOR;
+    }
+    catch {
+        return ENGINE_FLOOR;
+    }
+}
+/**
+ * The module table for engines without `getExpressionModuleCapabilities`
+ * (same values the library derives; `packages/adaptable/aql.ts`, S.1).
+ */
+const FALLBACK_CAPABILITIES = EXPRESSION_MODULES.map((module) => {
+    const kinds = module === 'CalculatedColumn'
+        ? ['scalar', 'boolean', 'aggregatedScalar']
+        : module === 'NamedQuery'
+            ? ['boolean', 'scalar']
+            : module === 'Alert'
+                ? ['boolean', 'aggregatedBoolean']
+                : ['boolean'];
+    const observable = ['Alert', 'CalculatedColumn', 'FormatColumn', 'FlashingCell'].includes(module);
+    const dataChange = ['Alert', 'FlashingCell'].includes(module);
+    return { module, kinds, observableCalls: observable, dataChangeFunctions: dataChange };
+});
+export function moduleCapabilities(engine) {
+    const fromEngine = engine.module.getExpressionModuleCapabilities?.();
+    return fromEngine ? { capabilities: fromEngine, fromEngine: true } : { capabilities: FALLBACK_CAPABILITIES, fromEngine: false };
+}
+export function capabilitiesOf(engine, module) {
+    return moduleCapabilities(engine).capabilities.find((c) => c.module === module);
+}
+export const isAggregatedKind = (kind) => kind === 'aggregatedScalar' || kind === 'aggregatedBoolean';
+//# sourceMappingURL=engine.js.map

package/dist/core/aql/engine.js.map

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

package/dist/core/aql/functions.js

@@ -0,0 +1,108 @@
+import { capabilitiesOf, isAggregatedKind } from './engine.js';
+const slugOf = (routePath) => routePath.replace(/^\/docs\//, '').replace(/^\//, '');
+/** Clause keywords that belong to observable expressions rather than aggregations */
+const OBSERVABLE_CLAUSES = new Set(['WITHIN', 'LAST_N', 'ALL_ROWS', 'ANY_COL', 'TRIGGER']);
+/**
+ * The AdapTableQL page that explains a function's family, when no page or
+ * heading names the function itself (the docs document standard functions in
+ * an index table, aggregations per family, observables with a heading each).
+ */
+function familySlug(fn) {
+    const category = fn.category?.toLowerCase() ?? '';
+    switch (fn.group) {
+        case 'observable':
+            return 'adaptable-ql-expression-observable';
+        case 'aggregation':
+            return category.includes('cumulative')
+                ? 'adaptable-ql-expression-cumulative'
+                : category.includes('quantile')
+                    ? 'adaptable-ql-expression-quantile'
+                    : category.includes('window')
+                        ? 'adaptable-ql-expression-window'
+                        : 'adaptable-ql-expression-aggregation';
+        case 'clause':
+            return OBSERVABLE_CLAUSES.has(fn.name.toUpperCase()) ? 'adaptable-ql-expression-observable' : 'adaptable-ql-expression-aggregation';
+        default:
+            return 'adaptable-ql-expression-functions';
+    }
+}
+/**
+ * Builds the name → slug index from the docs pages. A page under `adaptable-ql…`
+ * whose title or `##`/`###` headings name the function (`QUERY Function`,
+ * `` `CHANGE_COUNT` ``, `` `ALL_ROWS()` ``) wins; otherwise the function's family
+ * page, when the host has it. Functions whose family page is absent get no slug.
+ */
+export function buildFunctionDocsIndex(pages, functions) {
+    const wanted = new Set(functions.map((f) => f.name.toUpperCase()));
+    const index = new Map();
+    const slugs = new Set();
+    const consider = (text, slug) => {
+        const match = /^\s*`?([$A-Za-z][A-Za-z_0-9]*)/.exec(text);
+        const name = match?.[1]?.toUpperCase();
+        if (name && wanted.has(name) && !index.has(name)) {
+            index.set(name, slug);
+        }
+    };
+    for (const page of pages) {
+        const slug = slugOf(page.routePath);
+        if (!slug.startsWith('adaptable-ql')) {
+            continue;
+        }
+        slugs.add(slug);
+        consider(page.title, slug);
+        for (const heading of page.headings ?? []) {
+            consider(heading, slug);
+        }
+    }
+    for (const fn of functions) {
+        const name = fn.name.toUpperCase();
+        if (!index.has(name)) {
+            const family = familySlug(fn);
+            if (slugs.has(family)) {
+                index.set(name, family);
+            }
+        }
+    }
+    return index;
+}
+/** Whether a module offers a function, from the catalogue's `modules` (S.1) or, failing that, from the module's kinds */
+function offeredIn(entry, module, engine) {
+    if (entry.modules) {
+        return entry.modules.includes(module);
+    }
+    const capabilities = capabilitiesOf(engine, module);
+    if (!capabilities) {
+        return true;
+    }
+    if (entry.group === 'aggregation') {
+        return capabilities.kinds.some(isAggregatedKind);
+    }
+    if (entry.group === 'observable') {
+        return capabilities.observableCalls;
+    }
+    return true;
+}
+export function listFunctions(engine, options, docs) {
+    const needle = options.query?.toLowerCase();
+    return engine.module
+        .getExpressionFunctionCatalogue()
+        .filter((f) => !options.group || f.group === options.group)
+        .filter((f) => !options.module || offeredIn(f, options.module, engine))
+        .filter((f) => !needle || [f.name, f.description, f.category].some((v) => v?.toLowerCase().includes(needle)))
+        .map((f) => {
+        const slug = docs?.get(f.name.toUpperCase());
+        return {
+            name: f.name,
+            group: f.group,
+            ...(f.category ? { category: f.category } : {}),
+            callForm: f.callForm,
+            ...(f.returnType ? { returnType: f.returnType } : {}),
+            signatures: f.signatures,
+            examples: f.examples,
+            ...(f.description ? { description: f.description } : {}),
+            ...(f.modules ? { modules: f.modules } : {}),
+            ...(slug ? { docs: slug } : {}),
+        };
+    });
+}
+//# sourceMappingURL=functions.js.map

package/dist/core/aql/functions.js.map

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

package/dist/core/aql/migrate.js

@@ -0,0 +1,62 @@
+/**
+ * `migrate expression` (plan §8.9): one AdapTableQL expression through the
+ * engine's `migrateExpression` — the library's pre-24 → 24 rewrite (brace
+ * aggregations, named operands, legacy observable rules), the same logic as
+ * `expressionApi.migratePreV24Expression` — then validated with the engine's
+ * `aql` entry. The rewrite exists only for 24: a target below it has no
+ * expression changes, and validation is reported only when `to ≥ 24`.
+ */
+import { ENGINE_FLOOR } from '../constants.js';
+import { containsAggregation } from '../state/expressions.js';
+import { checkExpression } from './check.js';
+import { capabilitiesOf, isAggregatedKind } from './engine.js';
+const ALL_KINDS = ['boolean', 'scalar', 'aggregatedBoolean', 'aggregatedScalar'];
+/** Kinds to try, best first: the module's (or all), the aggregated ones first when the text aggregates */
+function candidateKinds(engine, request) {
+    if (request.kind) {
+        return [request.kind];
+    }
+    const expected = request.module ? (capabilitiesOf(engine, request.module)?.kinds ?? ALL_KINDS) : ALL_KINDS;
+    const aggregated = containsAggregation(request.expression, engine.aggregations);
+    const preferred = expected.filter((kind) => isAggregatedKind(kind) === aggregated);
+    return [...preferred, ...expected.filter((kind) => !preferred.includes(kind))];
+}
+export function migrateExpressionText(engine, request) {
+    const original = request.expression.trim();
+    const { module } = request;
+    const candidates = candidateKinds(engine, request);
+    if (request.to < ENGINE_FLOOR) {
+        return {
+            original,
+            migrated: original,
+            changed: false,
+            kind: candidates[0],
+            ...(module ? { module } : {}),
+            notes: [`AdapTableQL syntax did not change between ${request.from} and ${request.to}; the rewrite applies to ${ENGINE_FLOOR} and later.`],
+        };
+    }
+    // the kind: every candidate is tried; the best is a rewrite that changed something and validates,
+    // then one that changed something, then an unchanged expression that validates, then an unchanged
+    // one, then the first candidate with its error — ties go to the earlier (preferred) candidate
+    const attempts = candidates.map((kind) => {
+        const result = engine.module.migrateExpression(original, { kind });
+        const migrated = result.error ? original : result.expression;
+        const validation = checkExpression(engine, { expression: migrated, module, kind, columns: request.columns });
+        const changed = !result.error && result.changed;
+        const score = result.error ? -1 : changed ? (validation.ok ? 3 : 2) : validation.ok ? 1 : 0;
+        return { kind, result, migrated, validation, changed, score };
+    });
+    const best = attempts.reduce((top, attempt) => (attempt.score > top.score ? attempt : top), attempts[0]);
+    const { kind, result, migrated, validation, changed } = best;
+    return {
+        original,
+        migrated,
+        changed,
+        kind,
+        ...(module ? { module } : {}),
+        notes: result.notes ?? [],
+        ...(result.error ? { error: result.error } : {}),
+        validation,
+    };
+}
+//# sourceMappingURL=migrate.js.map

package/dist/core/aql/migrate.js.map

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

package/dist/core/capabilities.js

@@ -0,0 +1,105 @@
+/**
+ * The capability registry (plan §6.1). One entry per capability; the CLI tree,
+ * the MCP tool list, `--help --json`, `skills/_shared/capabilities.md` and the
+ * parity tests are all generated from it.
+ */
+import { resolve as resolvePath } from 'node:path';
+import { z } from 'zod';
+import { getManifestInfo } from './compat/manifest.js';
+import { resolveContext, } from './context/resolve.js';
+import { FRAMEWORKS } from './docs/corpus.js';
+import { CapabilityError, fail, SCHEMA_VERSION } from './envelope.js';
+export { CLI_PACKAGE, CLI_RANGE, CURRENT_DOCS_HOST, MIGRATION_FLOOR, PACKAGE_VERSION, RECORDS_FLOOR, } from './constants.js';
+export { SCHEMA_VERSION };
+/** Global flags shared by every command (plan §7.1); `--json` and `--quiet` are rendering flags the bindings own. */
+export const GlobalOptionsSchema = z.object({
+    cwd: z.string().optional().describe('Project folder; defaults to the current directory'),
+    major: z.number().int().optional().describe('AdapTable major to assume instead of detecting it'),
+    framework: z.enum(FRAMEWORKS).optional().describe('Framework to assume instead of detecting it'),
+    offline: z.boolean().optional().describe('Never touch the network; use caches and bundled snapshots'),
+    docsHost: z.string().optional().describe('Docs host to read instead of the default one'),
+});
+const registry = new Map();
+export function registerCapability(capability) {
+    if (registry.has(capability.name)) {
+        throw new Error(`Capability "${capability.name}" is already registered.`);
+    }
+    const command = capability.cli.command.join(' ');
+    for (const existing of registry.values()) {
+        if (existing.cli.command.join(' ') === command) {
+            throw new Error(`CLI command "${command}" is already bound to capability "${existing.name}".`);
+        }
+        if (capability.mcp && existing.mcp?.tool === capability.mcp.tool) {
+            throw new Error(`MCP tool "${capability.mcp.tool}" is already bound to capability "${existing.name}".`);
+        }
+    }
+    registry.set(capability.name, capability);
+}
+export function listCapabilities(options = {}) {
+    return [...registry.values()].filter((c) => options.includeHidden || !c.hidden);
+}
+export function getCapability(name) {
+    return registry.get(name);
+}
+/** Step 4 of §7.2 and the docs host map, from the manifest (hosted, cached or snapshot) */
+async function latestFromManifest(manifest) {
+    const info = await getManifestInfo(manifest);
+    return info
+        ? {
+            adaptableMajor: info.latest.adaptableMajor,
+            adaptableVersion: info.latest.adaptableVersion,
+            ...(info.docsHosts ? { docsHosts: info.docsHosts } : {}),
+        }
+        : undefined;
+}
+function usageMessage(error) {
+    return error.issues
+        .map((issue) => (issue.path.length ? `${issue.path.map(String).join('.')}: ${issue.message}` : issue.message))
+        .join('; ');
+}
+/**
+ * Validates `input` against the capability's schema, runs it and returns the
+ * envelope. `CapabilityError`s become failure envelopes; any other throw is a bug
+ * and propagates to the binding.
+ */
+export async function runCapability(name, input, globals = {}, options = {}) {
+    const capability = registry.get(name);
+    if (!capability) {
+        return fail('NOT_FOUND', `Unknown capability "${name}".`, 'Run `adaptable --help` for the commands this version supports; a skill that names a missing capability should fall back to the docs.');
+    }
+    const parsedGlobals = GlobalOptionsSchema.safeParse(globals);
+    if (!parsedGlobals.success) {
+        return fail('USAGE', `Invalid global options: ${usageMessage(parsedGlobals.error)}`, 'Run `adaptable --help`.');
+    }
+    const parsed = capability.input.safeParse(input ?? {});
+    if (!parsed.success) {
+        return fail('USAGE', `Invalid input for ${capability.cli.command.join(' ')}: ${usageMessage(parsed.error)}`, `Run \`adaptable ${capability.cli.command.join(' ')} --help\`.`);
+    }
+    const cwd = resolvePath(parsedGlobals.data.cwd ?? process.cwd());
+    const globalsWithCwd = { ...parsedGlobals.data, cwd };
+    const manifest = {
+        ...(parsedGlobals.data.offline !== undefined ? { offline: parsedGlobals.data.offline } : {}),
+        ...(parsedGlobals.data.docsHost !== undefined ? { docsHost: parsedGlobals.data.docsHost } : {}),
+        ...(options.manifestMaxAgeMs !== undefined ? { maxAgeMs: options.manifestMaxAgeMs } : {}),
+    };
+    let resolution;
+    const ctx = {
+        globals: parsedGlobals.data,
+        cwd,
+        manifest,
+        resolveContext: () => (resolution ??= resolveContext(globalsWithCwd, {
+            ...options.resolve,
+            latest: options.resolve?.latest ?? (() => latestFromManifest(manifest)),
+        })),
+    };
+    try {
+        return await capability.run(parsed.data, ctx);
+    }
+    catch (error) {
+        if (error instanceof CapabilityError) {
+            return error.toEnvelope();
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/core/capabilities.js.map

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

package/dist/core/changes/capabilities.js

@@ -0,0 +1,92 @@
+/**
+ * `adaptable changes [--from n] [--to m] [--repo <dir>] [--projects <dirs...>] [--all] [--with-docs]` · MCP `list_changes` (plan §8.10).
+ */
+import { existsSync, statSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { z } from 'zod';
+import { registerCapability } from '../capabilities.js';
+import { getManifestInfo } from '../compat/manifest.js';
+import { CapabilityError, ok } from '../envelope.js';
+import { listChanges } from './changes.js';
+import { AREAS } from './records.js';
+import { renderChanges } from './render-md.js';
+const Match = z.object({ file: z.string(), line: z.number(), token: z.string() });
+const Record = z.object({
+    id: z.string(),
+    area: z.enum(AREAS),
+    type: z.enum(['BREAKING', 'BEHAVIOUR', 'DEPRECATED']),
+    title: z.string(),
+    rows: z.array(z.object({ item: z.string(), before: z.string(), after: z.string(), autoMigrated: z.enum(['yes', 'partial', 'no', 'n/a']) })),
+    search: z.array(z.string()),
+    always: z.boolean(),
+    note: z.string().optional(),
+    docs: z.string(),
+    url: z.string(),
+    included: z.boolean(),
+    matches: z.array(Match).optional(),
+    matchCount: z.number().optional(),
+    docsSection: z.string().optional(),
+});
+const ChangesOutput = z.object({
+    from: z.number(),
+    to: z.number(),
+    recordsSource: z.enum(['hosted', 'bundled', 'mixed']),
+    transitions: z.array(z.object({
+        from: z.number(),
+        to: z.number(),
+        recordsSource: z.enum(['hosted', 'bundled']),
+        builtFrom: z.object({ releaseNote: z.string(), sourceSha256: z.string() }),
+        releaseNote: z.string(),
+        records: z.array(Record),
+    })),
+    missing: z.array(z.object({ from: z.number(), to: z.number(), releaseNote: z.string() })),
+    environment: z
+        .object({ node: z.string().optional(), typescript: z.string().optional(), react: z.string().optional(), angular: z.string().optional(), vue: z.string().optional() })
+        .optional(),
+    scanned: z.object({ projects: z.array(z.string()), files: z.number() }).optional(),
+    filtered: z.boolean(),
+});
+function projectDir(path, flag) {
+    const dir = resolve(path);
+    if (!existsSync(dir) || !statSync(dir).isDirectory()) {
+        throw new CapabilityError('NOT_FOUND', `${flag} ${path} is not a folder.`, 'Pass the project root (the folder holding its package.json).');
+    }
+    return dir;
+}
+registerCapability({
+    name: 'changes',
+    description: 'Lists the changes between two AdapTable majors from the release-note records; with --repo keeps the ones the project\'s code hits (file:line) and the ones that always apply.',
+    cli: { command: ['changes'] },
+    mcp: { tool: 'list_changes' },
+    input: z.object({
+        from: z.number().int().optional().describe('Major the project is on; defaults to the detected one'),
+        to: z.number().int().optional().describe('Target major; defaults to the newest the manifest knows'),
+        repo: z.string().optional().describe('Project folder to search for each record\'s tokens (CLI)'),
+        projects: z.array(z.string()).optional().describe('More project folders to search, e.g. workspace members (CLI)'),
+        all: z.boolean().optional().describe('With a search, keep every record rather than only the hit and always-on ones'),
+        withDocs: z.boolean().optional().describe('Inline each kept record\'s release-note section (needs the docs host; CLI)'),
+    }),
+    output: ChangesOutput,
+    run: async (input, ctx) => {
+        const resolution = await ctx.resolveContext();
+        const detected = resolution.context.source === 'latest' ? undefined : resolution.context.adaptableMajor;
+        const from = input.from ?? detected;
+        if (from === undefined) {
+            throw new CapabilityError('USAGE', 'The major the project is on could not be determined.', 'Pass `--from <major>`, or run inside the project.');
+        }
+        let to = input.to;
+        if (to === undefined) {
+            const manifest = await getManifestInfo(ctx.manifest);
+            to = manifest?.latest.adaptableMajor;
+            if (to === undefined) {
+                throw new CapabilityError('USAGE', 'The target major could not be determined (no manifest).', 'Pass `--to <major>`.');
+            }
+        }
+        const repo = input.repo ? projectDir(input.repo, '--repo') : undefined;
+        const projects = input.projects?.map((p) => projectDir(p, '--projects'));
+        const result = await listChanges({ from, to, repo, projects, all: input.all, withDocs: input.withDocs }, { cwd: repo ?? projects?.[0] ?? ctx.cwd, ...ctx.manifest });
+        return ok(result.data, { issues: result.issues, warnings: [...resolution.warnings, ...result.warnings], resolvedContext: resolution.context });
+    },
+    markdown: (data) => renderChanges(data),
+});
+//# sourceMappingURL=capabilities.js.map

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

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

package/dist/core/changes/changes.js

@@ -0,0 +1,101 @@
+/**
+ * `changes` (plan §8.10): the records of every transition in `(from, to]`,
+ * filtered by a literal search of the project when `--repo` / `--projects` is
+ * given (plus `always` records), with `environment` for the target major from
+ * the manifest and, on request, each kept record's release-note section inlined.
+ * Transport-free; `capabilities.ts` binds it.
+ */
+import { getManifestInfo } from '../compat/manifest.js';
+import { RECORDS_FLOOR } from '../constants.js';
+import { docsHostFor } from '../docs/hosts.js';
+import { CapabilityError } from '../envelope.js';
+import { scanProjects } from './grep.js';
+import { loadRecords } from './records.js';
+import { inlineSections } from './with-docs.js';
+export const releaseNoteSlug = (major) => `support/version-${major}0-release-note`;
+const severityOf = (type) => (type === 'BREAKING' ? 'error' : 'warning');
+export async function listChanges(input, deps = {}) {
+    const warnings = [];
+    if (!Number.isInteger(input.from) || !Number.isInteger(input.to) || input.from >= input.to) {
+        throw new CapabilityError('USAGE', `\`--from ${input.from}\` must be a whole major lower than \`--to ${input.to}\`.`, 'Example: `adaptable changes --from 23 --to 24 --repo .`');
+    }
+    let manifest;
+    try {
+        manifest = await (deps.manifest ?? (() => getManifestInfo({ offline: deps.offline, docsHost: deps.docsHost, maxAgeMs: deps.maxAgeMs })))();
+    }
+    catch {
+        manifest = undefined;
+    }
+    const hostInfo = { docsHosts: manifest?.docsHosts, latestMajor: manifest?.latest.adaptableMajor };
+    const hostFor = (major) => docsHostFor(major, hostInfo, deps.docsHost ?? process.env.ADAPTABLE_MCP_DOCS_HOST);
+    const noteUrl = (major) => `${hostFor(major)}/${releaseNoteSlug(major)}`;
+    if (input.from < RECORDS_FLOOR) {
+        const notes = Array.from({ length: Math.min(input.to, RECORDS_FLOOR) - input.from }, (_, i) => noteUrl(input.from + 1 + i));
+        throw new CapabilityError('VERSION_NOT_SUPPORTED', `Change records start at AdapTable ${RECORDS_FLOOR} (\`--from ${input.from}\` is below it).`, `Read the release notes for the majors below ${RECORDS_FLOOR} by hand: ${notes.join(', ')}; then run \`adaptable changes --from ${RECORDS_FLOOR} --to ${input.to}\`.`);
+    }
+    const loaded = await loadRecords({ from: input.from, to: input.to, offline: deps.offline, docsHost: deps.docsHost, maxAgeMs: deps.maxAgeMs, manifest: async () => manifest, fetchText: deps.fetchText });
+    warnings.push(...loaded.warnings);
+    if (!loaded.transitions.length) {
+        throw new CapabilityError('VERSION_NOT_SUPPORTED', `No change records exist yet for ${input.from} → ${input.to}.`, `Read the release notes by hand: ${loaded.missing.map((m) => noteUrl(m.to)).join(', ')}.`);
+    }
+    for (const m of loaded.missing) {
+        warnings.push(`No change records for ${m.from} → ${m.to} yet (its release note has no tagged Upgrade Guide tables); read ${noteUrl(m.to)} by hand — this plan is incomplete for that step.`);
+    }
+    const projects = [...(input.repo ? [input.repo] : []), ...(input.projects ?? [])];
+    const allRecords = loaded.transitions.flatMap((t) => t.file.records);
+    const scan = projects.length ? scanProjects(projects, allRecords, { cwd: deps.cwd ?? projects[0] }) : undefined;
+    const filtered = !!scan && !input.all;
+    const transitions = loaded.transitions.map((t) => ({
+        from: t.from,
+        to: t.to,
+        recordsSource: t.source,
+        builtFrom: t.file.builtFrom,
+        releaseNote: noteUrl(t.to),
+        records: t.file.records.map((record) => {
+            const hits = scan?.byRecord.get(record.id);
+            const included = !filtered || record.always || record.search.length === 0 || !!hits;
+            return {
+                ...record,
+                url: `${hostFor(t.to)}/${record.docs}`,
+                included,
+                ...(scan ? { matches: hits?.matches ?? [], matchCount: hits?.total ?? 0 } : {}),
+            };
+        }),
+    }));
+    if (input.withDocs) {
+        if (deps.offline) {
+            warnings.push('--with-docs needs the docs host; skipped under --offline.');
+        }
+        else {
+            warnings.push(...(await inlineSections(transitions, { offline: deps.offline, docsHost: deps.docsHost, maxAgeMs: deps.maxAgeMs })));
+        }
+    }
+    const issues = scan
+        ? transitions.flatMap((t) => t.records
+            .filter((r) => r.included)
+            .map((r) => ({
+            code: `change/${r.type.toLowerCase()}`,
+            severity: severityOf(r.type),
+            message: `${t.from} → ${t.to} · ${r.area}: ${r.title}${r.matchCount ? ` — ${r.matchCount} match${r.matchCount === 1 ? '' : 'es'}` : r.always ? ' — applies to every project' : ''}`,
+            ...(r.note ? { fix: r.note } : {}),
+            ...(r.matches?.[0] ? { file: r.matches[0].file, line: r.matches[0].line } : {}),
+            docs: r.docs,
+        })))
+        : [];
+    const sources = new Set(transitions.map((t) => t.recordsSource));
+    return {
+        data: {
+            from: input.from,
+            to: input.to,
+            recordsSource: sources.size === 1 ? [...sources][0] : 'mixed',
+            transitions,
+            missing: loaded.missing.map((m) => ({ ...m, releaseNote: noteUrl(m.to) })),
+            ...(manifest?.environment?.[String(input.to)] ? { environment: manifest.environment[String(input.to)] } : {}),
+            ...(scan ? { scanned: { projects, files: scan.scannedFiles } } : {}),
+            filtered,
+        },
+        issues,
+        warnings,
+    };
+}
+//# sourceMappingURL=changes.js.map

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

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