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

package/dist/tools/checks.js

@@ -1,250 +0,0 @@
-import { z } from 'zod';
-import { loadEntry } from '../adaptable/loadEntry.js';
-import { EXPRESSION_MODULES, } from '../adaptable/types.js';
-import { checkStateRules, collectExpressions, getStateColumnIds, } from '../checks/stateRules.js';
-import { typeCheckState, unexplainedTypeIssues } from '../checks/stateTypes.js';
-import { resolveProjectPath } from '../context.js';
-const KIND = z
-    .enum(['boolean', 'scalar', 'aggregatedScalar', 'aggregatedBoolean'])
-    .describe('boolean: filters, rules, boolean Named Queries, Relative Change (ANY_CHANGE()) and boolean Observable rules (CHANGE_COUNT{...} >= n); scalar: Calculated Columns and Named Queries returning a value, Observable values (MAX{[x], WITHIN(1d)}); aggregatedScalar: Calculated Columns with SUM{...}, Cumulative, Quantile or Window (LAG, RANK) expressions; aggregatedBoolean: Alert rules with aggregation (SUM{[x]} > n)');
-const MODULE = z
-    .enum(EXPRESSION_MODULES)
-    .optional()
-    .describe("Module the expression is used in. Pass it: Observable functions, Relative Change functions, Cumulative / Window functions and aggregations are only available in some Modules");
-const COLUMNS = z
-    .array(z.object({ id: z.string(), dataType: z.string().optional() }))
-    .optional()
-    .describe("Grid columns from columnDefs (colId or field), with AdapTable data types (text, number, boolean, date, textArray, numberArray, ...); enables column checks");
-const STATE = z
-    .union([z.string(), z.record(z.string(), z.unknown())])
-    .describe('Initial State as a JSON object or JSON string (convert TypeScript object literals to JSON)');
-const CUSTOM_NOTE = 'Custom expression functions, custom aggregations and Named Queries from AdaptableOptions / state are not known to this check; issues about those names can be ignored.';
-const text = (value) => ({ content: [{ type: 'text', text: value }] });
-const failure = (value) => ({ ...text(value), isError: true });
-function formatIssue(expression, issue) {
-    let line = `- ${issue.severity}${issue.code ? ` ${issue.code}` : ''}: ${issue.message}`;
-    if (issue.range) {
-        line += ` (at ${issue.range[0]}-${issue.range[1]}: \`${expression.slice(issue.range[0], issue.range[1])}\`)`;
-    }
-    if (issue.quickFix) {
-        line += `\n  fix: ${issue.quickFix.label} -> \`${issue.quickFix.replacement}\``;
-    }
-    return line;
-}
-function summarize(lines, clean) {
-    const count = (severity) => lines.filter((l) => new RegExp(`^\\s*- ${severity}\\b`).test(l)).length;
-    const errors = count('error');
-    const warnings = count('warning');
-    if (!errors && !warnings) {
-        return clean;
-    }
-    return `${errors} error(s), ${warnings} warning(s)${errors ? '; fix the errors' : ''}:`;
-}
-const toColumnTypes = (columns) => columns ? Object.fromEntries(columns.map((c) => [c.id, c.dataType])) : undefined;
-function parseState(state) {
-    if (typeof state !== 'string') {
-        return state;
-    }
-    try {
-        const parsed = JSON.parse(state);
-        return parsed && typeof parsed === 'object' && !Array.isArray(parsed)
-            ? parsed
-            : 'State must be a JSON object.';
-    }
-    catch (error) {
-        return `State is not valid JSON (${error instanceof Error ? error.message : String(error)}). Convert the TypeScript object literal to JSON: quote keys, no comments, no trailing commas, no functions.`;
-    }
-}
-async function getAql(projectPath) {
-    return loadEntry(await projectPath, 'aql');
-}
-function checkOne(aql, expression, kind, module, columns) {
-    const result = aql.validateExpression(expression, { kind, module, columns });
-    const lines = result.issues.map((issue) => formatIssue(expression, issue));
-    if (!result.isValid) {
-        const migrated = aql.migrateExpression(expression, { kind });
-        if (!migrated.error && migrated.changed) {
-            const recheck = aql.validateExpression(migrated.expression, { kind, module, columns });
-            const errorCount = (issues) => issues.filter((issue) => issue.severity === 'error').length;
-            if (errorCount(recheck.issues) < errorCount(result.issues)) {
-                lines.push(`  This is pre-v24 syntax. v24 form: \`${migrated.expression}\`${recheck.isValid ? ' (valid)' : ' (still has issues)'}`);
-            }
-        }
-    }
-    return lines;
-}
-export function registerCheckTools(server) {
-    server.registerTool('check_expression', {
-        title: 'Check an AdapTableQL expression',
-        description: "Validates an AdapTableQL expression with the AdapTable version installed in the project: syntax, known functions, argument types, aggregation rules, (with module) the functions that Module offers, and (with columns) column references and data types. Returns issues with positions and quick fixes; pre-v24 syntax gets the v24 rewrite. Run it on every expression before presenting config.",
-        inputSchema: {
-            expression: z.string(),
-            kind: KIND,
-            module: MODULE,
-            columns: COLUMNS,
-            projectPath: z.string().optional(),
-        },
-        annotations: { readOnlyHint: true },
-    }, async ({ expression, kind, module, columns, projectPath }) => {
-        const loaded = await getAql(resolveProjectPath(server, projectPath));
-        if (!loaded.ok) {
-            return failure(loaded.reason);
-        }
-        const lines = checkOne(loaded.module, expression, kind, module, toColumnTypes(columns));
-        return text([
-            summarize(lines, 'Expression is valid.'),
-            ...lines,
-            '',
-            CUSTOM_NOTE,
-        ].join('\n'));
-    });
-    server.registerTool('migrate_expression', {
-        title: 'Migrate an AdapTableQL expression to v24',
-        description: 'Rewrites a pre-v24 AdapTableQL expression (legacy function spellings, paren-form aggregations such as SUM([x]), old clauses) into v24 syntax, using the installed AdapTable version.',
-        inputSchema: { expression: z.string(), kind: KIND.optional(), projectPath: z.string().optional() },
-        annotations: { readOnlyHint: true },
-    }, async ({ expression, kind, projectPath }) => {
-        const loaded = await getAql(resolveProjectPath(server, projectPath));
-        if (!loaded.ok) {
-            return failure(loaded.reason);
-        }
-        const result = loaded.module.migrateExpression(expression, { kind });
-        if (result.error) {
-            return failure(`Could not migrate: ${result.error}`);
-        }
-        const notes = result.notes?.length
-            ? `\n\nThe rewrite changes behaviour; tell the user:\n${result.notes.map((n) => `- ${n}`).join('\n')}`
-            : '';
-        return text(result.changed
-            ? `v24 form:\n${result.expression}${notes}`
-            : `Already v24 syntax; no changes:\n${result.expression}`);
-    });
-    server.registerTool('list_expression_functions', {
-        title: 'List AdapTableQL functions',
-        description: 'Built-in AdapTableQL functions, aggregations, observable functions and clauses of the installed AdapTable version, with signatures and examples. Filter by group or by text.',
-        inputSchema: {
-            group: z.enum(['scalar', 'aggregation', 'observable', 'clause']).optional(),
-            query: z.string().optional().describe('Case-insensitive match on name, description or category'),
-            projectPath: z.string().optional(),
-        },
-        annotations: { readOnlyHint: true },
-    }, async ({ group, query, projectPath }) => {
-        const loaded = await getAql(resolveProjectPath(server, projectPath));
-        if (!loaded.ok) {
-            return failure(loaded.reason);
-        }
-        const needle = query?.toLowerCase();
-        const entries = loaded.module
-            .getExpressionFunctionCatalogue()
-            .filter((f) => !group || f.group === group)
-            .filter((f) => !needle ||
-            [f.name, f.description, f.category].some((v) => v?.toLowerCase().includes(needle)));
-        if (!entries.length) {
-            return text('No matching functions.');
-        }
-        return text(entries
-            .map((f) => [
-            `## ${f.name} (${f.group}${f.category ? `, ${f.category}` : ''}${f.returnType ? ` -> ${f.returnType}` : ''})`,
-            f.description,
-            ...f.signatures.map((s) => `- \`${s}\``),
-            ...f.examples.slice(0, 2).map((e) => `- e.g. \`${e}\``),
-        ]
-            .filter(Boolean)
-            .join('\n'))
-            .join('\n\n'));
-    });
-    server.registerTool('check_state', {
-        title: 'Check AdapTable Initial State',
-        description: "Checks an Initial State object: type-checks it against InitialState from the installed AdapTable (wrong or missing properties, pre-v24 shapes), plus semantic checks TypeScript cannot catch: unknown sections (e.g. PredefinedConfig), unique Layout names, CurrentLayout present, Table vs Pivot Layout properties, Width xor Flex, column references (with columns), and every embedded AdapTableQL expression validated as check_expression would.",
-        inputSchema: { state: STATE, columns: COLUMNS, projectPath: z.string().optional() },
-        annotations: { readOnlyHint: true },
-    }, async ({ state, columns, projectPath }) => {
-        const parsed = parseState(state);
-        if (typeof parsed === 'string') {
-            return failure(parsed);
-        }
-        const loaded = await getAql(resolveProjectPath(server, projectPath));
-        const aggregations = new Map(loaded.ok
-            ? loaded.module
-                .getExpressionFunctionCatalogue()
-                .filter((f) => f.group === 'aggregation')
-                .map((f) => [f.name.toUpperCase(), f.callForm])
-            : []);
-        const ruleIssues = checkStateRules(parsed, { columnIds: columns?.map((c) => c.id) });
-        const typed = await typeCheckState(await resolveProjectPath(server, projectPath), parsed);
-        const typeIssues = typed.ok ? unexplainedTypeIssues(typed.issues, ruleIssues) : [];
-        const lines = [
-            ...ruleIssues.map((issue) => `- ${issue.severity} at ${issue.path || '(root)'}: ${issue.message}`),
-            ...typeIssues.map((issue) => `- ${issue.severity} at ${issue.path || '(root)'}: (types) ${issue.message}`),
-        ];
-        if (!typed.ok) {
-            lines.push(`- warning: types not checked: ${typed.reason}`);
-        }
-        const expressions = collectExpressions(parsed, aggregations);
-        if (loaded.ok) {
-            const columnTypes = columns
-                ? { ...Object.fromEntries(getStateColumnIds(parsed)), ...toColumnTypes(columns) }
-                : undefined;
-            for (const { path, expression, kind, module } of expressions) {
-                const issues = checkOne(loaded.module, expression, kind, module, columnTypes);
-                if (issues.length) {
-                    lines.push(`- expression at ${path} (${module}, ${kind}): \`${expression}\``, ...issues.map((l) => `  ${l}`));
-                }
-            }
-        }
-        else {
-            lines.push(`- warning: expressions not checked: ${loaded.reason}`);
-        }
-        return text([
-            summarize(lines, 'No problems found.'),
-            ...lines,
-            '',
-            `Checked ${expressions.length} expression(s)${typed.ok ? ` and the state's types (against ${typed.source})` : ''}. ${CUSTOM_NOTE}`,
-        ].join('\n'));
-    });
-    server.registerTool('migrate_state', {
-        title: 'Migrate AdapTable state to the installed version',
-        description: "Upgrades an Initial State (or persisted state) object from an older AdapTable major version using AdaptableUpgradeHelper.migrateAdaptableState from the installed package — the same migration AdapTable runs at startup. Install the target AdapTable version first. Returns the migrated JSON and the migration log; run check_state on the result.",
-        inputSchema: {
-            state: STATE,
-            fromVersion: z.number().int().describe('AdapTable major version the state was written for, e.g. 22'),
-            toVersion: z.number().int().optional().describe('Defaults to the installed major version'),
-            projectPath: z.string().optional(),
-        },
-        annotations: { readOnlyHint: true },
-    }, async ({ state, fromVersion, toVersion, projectPath }) => {
-        const parsed = parseState(state);
-        if (typeof parsed === 'string') {
-            return failure(parsed);
-        }
-        const loaded = await loadEntry(await resolveProjectPath(server, projectPath), 'upgrade');
-        if (!loaded.ok) {
-            return failure(loaded.reason);
-        }
-        const helper = loaded.module.AdaptableUpgradeHelper;
-        const target = toVersion ?? helper.getCurrentMajorVersion();
-        if (fromVersion >= target) {
-            return failure(`fromVersion (${fromVersion}) must be lower than the target version (${target}).`);
-        }
-        const log = [];
-        const record = (level) => (message) => log.push(`- ${level}: ${message}`);
-        const logger = {
-            success: record('success'),
-            info: record('info'),
-            warn: record('warning'),
-            error: record('error'),
-        };
-        const migrated = helper.migrateAdaptableState(parsed, { fromVersion, toVersion: target, logger });
-        return text([
-            `Migrated from ${fromVersion} to ${target}.`,
-            '',
-            'Migration log:',
-            ...(log.length ? log : ['- (no messages)']),
-            '',
-            '```json',
-            JSON.stringify(migrated, null, 2),
-            '```',
-        ].join('\n'));
-    });
-}
-//# sourceMappingURL=checks.js.map

package/dist/tools/checks.js.map

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

package/dist/tools/docs.js

@@ -1,173 +0,0 @@
-import { z } from 'zod';
-import { filterFramework, FRAMEWORKS } from '../docs/corpus.js';
-import { loadCorpus } from '../docs/source.js';
-import { pageUrl, pickFramework, resolveEnvironment } from '../context.js';
-const CATEGORIES = [
-    'getting-started',
-    'handbook',
-    'dev-guide',
-    'adaptable-ql',
-    'ui',
-    'api',
-    'technical-reference',
-    'framework',
-    'integrations',
-    'demos',
-    'documentation',
-    'support',
-    'release-notes',
-];
-const MAX_SECTION_CHARS = 1800;
-const MAX_PAGE_CHARS = 40_000;
-const text = (value) => ({ content: [{ type: 'text', text: value }] });
-function truncate(value, max) {
-    return value.length > max ? `${value.slice(0, max)}\n… (truncated; use get_doc for the full page)` : value;
-}
-function docsHeader(corpus, framework, envMajor) {
-    const lines = [
-        `Docs: AdapTable ${corpus.manifest.adaptableVersion} from ${corpus.origin}; framework: ${framework ?? 'all'}`,
-    ];
-    if (envMajor !== undefined && envMajor !== corpus.manifest.major) {
-        lines.push(`Warning: this project uses AdapTable ${envMajor}, but these docs are for ${corpus.manifest.major}.`);
-    }
-    return lines.join('\n');
-}
-/** Accepts a slug, a route path or a docs URL (with or without `.md`) */
-export function findPage(corpus, page) {
-    const routePath = page
-        .trim()
-        .replace(/^https?:\/\/[^/]+/, '')
-        .replace(/[?#].*$/, '')
-        .replace(/\/index\.md$|\.md$/, '')
-        .replace(/\/+$/, '');
-    const candidates = /^\/(docs|support)(\/|$)/.test(routePath)
-        ? [routePath]
-        : [
-            `/docs/${routePath}`,
-            `/docs/reference/${routePath.toLowerCase()}`,
-            `/support/${routePath}`,
-        ];
-    for (const candidate of candidates) {
-        const found = corpus.pages.get(candidate) ?? corpus.pages.get(candidate.toLowerCase());
-        if (found) {
-            return found;
-        }
-    }
-    return undefined;
-}
-function extractHeading(markdown, heading) {
-    const lines = markdown.split('\n');
-    const target = heading.trim().toLowerCase();
-    let start = -1;
-    let level = 0;
-    let inFence = false;
-    for (let i = 0; i < lines.length; i++) {
-        if (/^\s*(```|~~~)/.test(lines[i])) {
-            inFence = !inFence;
-        }
-        if (inFence) {
-            continue;
-        }
-        const match = lines[i].match(/^(#{1,6})\s+(.+)$/);
-        if (!match) {
-            continue;
-        }
-        if (start < 0 && match[2].trim().toLowerCase().includes(target)) {
-            start = i;
-            level = match[1].length;
-        }
-        else if (start >= 0 && match[1].length <= level) {
-            return lines.slice(start, i).join('\n');
-        }
-    }
-    return start >= 0 ? lines.slice(start).join('\n') : undefined;
-}
-function outline(markdown) {
-    let inFence = false;
-    return markdown
-        .split('\n')
-        .filter((line) => {
-        if (/^\s*(```|~~~)/.test(line)) {
-            inFence = !inFence;
-        }
-        return !inFence && /^#{2,4}\s/.test(line);
-    })
-        .join('\n');
-}
-export function registerDocsTools(server) {
-    server.registerTool('search_docs', {
-        title: 'Search AdapTable docs',
-        description: "Search the AdapTable documentation for the project's AdapTable version and framework. Returns matching sections with canonical URLs. Use exact API names (e.g. `LayoutApi`, `CalculatedColumn`, `GROUP_BY`) or plain questions. For AG Grid itself (columnDefs, AG Grid modules, row models, grid API) use AG Grid's ag-mcp instead.",
-        inputSchema: {
-            query: z.string().describe('What to look for'),
-            category: z
-                .enum(CATEGORIES)
-                .optional()
-                .describe('Restrict to one docs area; `api` is the generated API reference. Release notes (old syntax, upgrade steps) are searched only with `release-notes`'),
-            framework: z
-                .enum(FRAMEWORKS)
-                .optional()
-                .describe('Defaults to the framework detected in the project'),
-            limit: z.number().int().min(1).max(20).optional(),
-            projectPath: z.string().optional().describe('Project folder; defaults to the workspace'),
-        },
-        annotations: { readOnlyHint: true, openWorldHint: true },
-    }, async ({ query, category, framework: requestedFramework, limit, projectPath }) => {
-        const env = await resolveEnvironment(server, projectPath);
-        const framework = pickFramework(requestedFramework, env);
-        const corpus = await loadCorpus(env.adaptableMajor);
-        const hits = corpus.index.search(query, {
-            framework,
-            categories: category ? [category] : undefined,
-            excludeCategories: ['release-notes'],
-            limit: limit ?? 6,
-        });
-        if (!hits.length) {
-            return text(`${docsHeader(corpus, framework, env.adaptableMajor)}\n\nNo matches for "${query}".`);
-        }
-        const body = hits
-            .map(({ section }, i) => {
-            const trail = [section.pageTitle, ...section.headings].join(' > ');
-            const url = pageUrl(corpus.manifest.baseUrl, section.routePath, framework);
-            return `## ${i + 1}. ${trail}\nPage: ${section.routePath} (${section.category}) ${url}\n\n${truncate(section.text, MAX_SECTION_CHARS)}`;
-        })
-            .join('\n\n---\n\n');
-        return text(`${docsHeader(corpus, framework, env.adaptableMajor)}\n\n${body}`);
-    });
-    server.registerTool('get_doc', {
-        title: 'Read an AdapTable docs page',
-        description: "Read one AdapTable docs page as markdown, for the project's version, with other frameworks' sections removed. Pass a slug (`handbook-calculated-column`), an API reference name (`layoutapi`), a release note (`version-240-release-note`), `release-schedule`, a route (`/docs/...`) or a docs URL. Long pages return an outline; pass `heading` to read one section.",
-        inputSchema: {
-            page: z.string(),
-            heading: z.string().optional().describe('Return only the section under this heading'),
-            framework: z.enum(FRAMEWORKS).optional(),
-            projectPath: z.string().optional(),
-        },
-        annotations: { readOnlyHint: true, openWorldHint: true },
-    }, async ({ page, heading, framework: requestedFramework, projectPath }) => {
-        const env = await resolveEnvironment(server, projectPath);
-        const framework = pickFramework(requestedFramework, env);
-        const corpus = await loadCorpus(env.adaptableMajor);
-        const found = findPage(corpus, page);
-        if (!found) {
-            const suggestions = corpus.index
-                .search(page.replace(/[-/]/g, ' '), { limit: 5 })
-                .map((hit) => hit.section.routePath);
-            return text(`No docs page "${page}". Closest pages:\n${[...new Set(suggestions)].map((p) => `- ${p}`).join('\n')}`);
-        }
-        let markdown = filterFramework(found.markdown, framework);
-        if (heading) {
-            const section = extractHeading(markdown, heading);
-            if (!section) {
-                return text(`No heading matching "${heading}" in ${found.routePath}. Outline:\n${outline(markdown)}`);
-            }
-            markdown = section;
-        }
-        else if (markdown.length > MAX_PAGE_CHARS) {
-            markdown = `${markdown.slice(0, MAX_PAGE_CHARS)}\n\n… (page truncated; pass \`heading\` to read a section)\n\nOutline:\n${outline(markdown)}`;
-        }
-        const url = pageUrl(corpus.manifest.baseUrl, found.routePath, framework);
-        return text(`${docsHeader(corpus, framework, env.adaptableMajor)}\nURL: ${url}\n\n${markdown}`);
-    });
-}
-//# sourceMappingURL=docs.js.map

package/dist/tools/docs.js.map

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

package/dist/tools/environment.js

@@ -1,52 +0,0 @@
-import { z } from 'zod';
-import { getManifest } from '../docs/source.js';
-import { getEnvironmentWarnings } from '../environment.js';
-import { resolveEnvironment } from '../context.js';
-const describePackage = (p) => `- ${p.name}: ${p.installed ? `installed ${p.installed}` : 'not installed'}${p.declared ? ` (package.json: ${p.declared})` : ''}`;
-export function registerEnvironmentTools(server) {
-    server.registerTool('detect_environment', {
-        title: 'Detect AdapTable setup',
-        description: "Call this first. Reads the project's package.json and node_modules: AdapTable version and framework wrapper, AG Grid packages, whether AG Grid satisfies AdapTable's peer range and documented pairing, and which docs version the other tools will use. Returns warnings for setup mistakes (Community instead of Enterprise, version mismatches).",
-        inputSchema: {
-            projectPath: z.string().optional().describe('Project folder; defaults to the workspace'),
-        },
-        annotations: { readOnlyHint: true, openWorldHint: true },
-    }, async ({ projectPath }) => {
-        const env = await resolveEnvironment(server, projectPath);
-        const manifestResult = await getManifest(env.adaptableMajor);
-        const manifest = 'manifest' in manifestResult ? manifestResult.manifest : undefined;
-        const warnings = getEnvironmentWarnings(env, manifest?.agGridPairings);
-        const lines = [`Project: ${env.projectPath}`];
-        if (env.adaptable) {
-            lines.push(`AdapTable: ${env.adaptable.installed ?? env.adaptable.declared ?? 'unknown'} (major ${env.adaptableMajor ?? 'unknown'})`, `Framework: ${env.framework ?? 'unknown'}`);
-        }
-        else {
-            lines.push('AdapTable: not installed (docs default to the latest version)');
-        }
-        if (env.agGridPeer) {
-            lines.push(`AdapTable requires ag-grid-enterprise ${env.agGridPeer}`);
-        }
-        if (env.adaptablePackages.length) {
-            lines.push('', 'AdapTable packages:', ...env.adaptablePackages.map(describePackage));
-        }
-        if (env.agGridPackages.length) {
-            lines.push('', 'AG Grid packages:', ...env.agGridPackages.map(describePackage));
-        }
-        lines.push('');
-        if ('manifest' in manifestResult) {
-            const { manifest, origin } = manifestResult;
-            lines.push(`Docs: AdapTable ${manifest.adaptableVersion} from ${origin}`);
-            const pairing = manifest.agGridPairings.find((p) => Number(p.adaptableVersion.split('.')[0]) === (env.adaptableMajor ?? manifest.major));
-            if (pairing) {
-                lines.push(`Documented pairing: AdapTable ${pairing.adaptableVersion} with AG Grid ${pairing.agGridMajor} (${pairing.agGridVersion})`);
-            }
-        }
-        else {
-            lines.push(`Docs: unavailable (${'error' in manifestResult ? manifestResult.error : ''})`);
-        }
-        lines.push('', warnings.length ? 'Warnings:' : 'No setup problems found.', ...warnings.map((w) => `- ${w}`));
-        lines.push('', 'For AG Grid questions (columnDefs, AG Grid modules, row models, grid API) use the ag-mcp server.');
-        return { content: [{ type: 'text', text: lines.join('\n') }] };
-    });
-}
-//# sourceMappingURL=environment.js.map

package/dist/tools/environment.js.map

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

package/skills/adaptable-dev/SKILL.md

@@ -1,42 +0,0 @@
----
-name: adaptable-dev
-description: Write, review and upgrade AdapTable code (the AG Grid extension in @adaptabletools/* packages) for the version the project uses. Use when code imports from @adaptabletools/*, or the user asks about AdapTable options, Initial State, Layouts, AdapTableQL expressions or upgrading AdapTable.
----
-
-# AdapTable development
-
-AdapTable's options, state shapes and AdapTableQL syntax change between major versions. What you remember is probably from an older version and will look right but fail. Look things up and check them with the `adaptable` MCP server (`@adaptabletools/adaptable-mcp`) instead.
-
-## Workflow
-
-1. Call `detect_environment` first. Fix the setup problems it reports before anything else.
-2. Before writing AdapTable config, find the current form with `search_docs` (exact names work best: `LayoutApi`, `CalculatedColumn`, `GROUP_BY`) and `get_doc`. Cite the URLs.
-3. Write the code.
-4. Run `check_expression` (with the `module` the expression belongs to) on every AdapTableQL expression and `check_state` on every Initial State, passing the grid's columns (`colId` or `field`, with AdapTable data types). Fix every error before showing the code.
-5. Type-check or build the project.
-
-If the server is not available, read the docs for the project's major version at `https://www.adaptabletools.com/llms.txt` (older majors: `https://v{major}.adaptabletools.com/llms.txt`).
-
-## Where settings go
-
-- **Adaptable Options**: design-time configuration users cannot change, such as `primaryKey`, `licenseKey`, `adaptableId`, entitlements (`entitlementOptions`), custom AdapTableQL functions (`expressionOptions`), Action Columns (`actionColumnOptions`) and other `*Options`.
-- **Initial State** (`initialState` in Adaptable Options): objects users can edit and that get persisted, such as Layouts, Calculated Columns, Format Columns, Alerts and Named Queries. There is no `PredefinedConfig`.
-- **Adaptable API**: runtime changes from application code, once AdapTable is ready.
-
-## AdapTableQL (version 24)
-
-- Expressions are plain strings: `Rule: '[pnl] < 0'`, `Expression: '[price] * [quantity]'`. Do not use `{ BooleanExpression: ... }` wrappers, `Query`, or Predicates.
-- Aggregations use braces: `SUM{[notional], GROUP_BY([desk])}`, not `SUM([notional])`. Basically braces are for functions that work on multiple rows. In this example, make the sum of all notionals, while grouping by desk.
-- When converting older expressions or state, use `migrate_expression` and `migrate_state`, not hand edits.
-
-## AdapTable and AG Grid
-
-AdapTable requires AG Grid Enterprise (`ag-grid-enterprise`), at the version `detect_environment` reports. For AG Grid questions (`columnDefs`, AG Grid modules, row models, grid API), use AG Grid's `ag-mcp` server or AG Grid docs, not this one.
-
-## Upgrades
-
-Use the `upgrade-adaptable` prompt, or follow it by hand:
-
-1. Read the release note of every version in between (`get_doc("version-240-release-note")`, and so on).
-2. Run `migrate_state` on each Initial State and `migrate_expression` on expressions outside state.
-3. Run `check_state` and `check_expression` on the results, then build.