@adaptabletools/adaptable-mcp 0.0.0-stage → 0.1.0-canary.1

package/README.md

@@ -1,3 +1,91 @@
-# Temporary Holding Version
+# @adaptabletools/adaptable-mcp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+One package, two modes, for coding agents working on [AdapTable](https://www.adaptabletools.com) projects:
+
+- **`adaptable`** — a CLI that the AdapTable Agent Skills call. It reads the docs for the AdapTable version a project actually uses, checks Initial State, AdapTableQL expressions and setup against the installed package, migrates State and expressions between majors, lists what changed between versions, and scaffolds a grid from your data.
+- **`adaptable mcp`** — the same capabilities as an [MCP](https://modelcontextprotocol.io) server over stdio, for harnesses and chat clients that discover MCP tools better than skills, or have no shell.
+
+The agent still writes the code; this package looks things up and checks them. For AG Grid itself (column definitions, AG Grid modules, row models, grid API) use AG Grid's `ag-dev` skill or [ag-mcp](https://www.ag-grid.com/javascript-data-grid/mcp-server/) alongside it.
+
+Requires Node 20+. Full guide: [getting-started-ai-cli](https://www.adaptabletools.com/docs/getting-started-ai-cli).
+
+> This package is being rebuilt. The commands below describe the target contract; the published `canary` line fills them in milestone by milestone, and `adaptable --help` lists what the installed version supports.
+
+## Skills first
+
+Install the AdapTable Agent Skills into a project; they tell the agent when to run the CLI and how to read its output:
+
+```bash
+npx skills add https://www.adaptabletools.com
+```
+
+Nothing else is required: the skills invoke `npx -y @adaptabletools/adaptable-mcp@^1 …` on demand.
+
+## The CLI
+
+```bash
+npx -y @adaptabletools/adaptable-mcp@^1 <command> [options]
+```
+
+| Command | What it does |
+| --- | --- |
+| `detect` | AdapTable and AG Grid packages, framework, compatibility of the project |
+| `compat --adaptable <major>` | AG Grid pairing, wrapper versions and environment requirements for a major |
+| `docs list\|search\|get\|demos\|demo` | The docs for the project's version and framework, as Markdown |
+| `check state\|expression\|setup` | Initial State, AdapTableQL expressions and Adaptable Options against the installed package |
+| `aql functions` | The AdapTableQL function catalogue, per module |
+| `migrate state\|expression` | From an older major to a newer one, with leftovers reported |
+| `changes --from <major> --to <major>` | What changed between two majors, grepped against the project |
+| `convert coldefs` | AG Grid `columnDefs` → AdapTable Layout and Format Columns |
+| `scaffold` | A new grid project from a CSV / JSON / XLSX sample |
+| `anonymise` | Strip values from a State or Grid Info before sharing it |
+| `cache add\|list\|clear` | Download a major's package for offline use |
+
+Global flags: `--cwd <dir>`, `--major <n>`, `--framework <fw>`, `--offline`, `--quiet`, `--json`, `--docs-host <url>`. Output is Markdown by default; `--json` returns a stable envelope. Exit codes: `0` ok · `1` findings · `2` usage · `3` environment.
+
+Install it as a devDependency for restricted networks, cold-start avoidance and CI:
+
+```bash
+npm i -D @adaptabletools/adaptable-mcp
+npx adaptable cache add 24   # for machines without registry access later
+```
+
+## The MCP server
+
+Point an MCP client at the same binary with the `mcp` argument (without it the binary prints help and exits):
+
+```json
+{
+  "mcpServers": {
+    "adaptable": { "command": "npx", "args": ["-y", "@adaptabletools/adaptable-mcp@^1", "mcp"] }
+  }
+}
+```
+
+Cursor reads this from `.cursor/mcp.json`, Claude Code from `.mcp.json`; Codex takes the equivalent `[mcp_servers.adaptable]` block in `~/.codex/config.toml`. The server exposes the checking, docs and migration capabilities as tools with the same results as the CLI's `--json` output.
+
+## How it works
+
+- Docs come from the build-time export of the docs site (`/llms/manifest.json`, `pages.json`, one `.md` per page, the demos index), re-validated with a conditional request on every call and cached under `~/.cache/adaptable-mcp/`.
+- Checks and migrations use the installed `@adaptabletools/adaptable` where the project has one, otherwise a cached copy of the right major; nothing is bundled from an older version of AdapTable's types.
+- No telemetry; the only writer is `scaffold --out`.
+
+## Environment variables
+
+| Variable | Default | Use |
+| --- | --- | --- |
+| `ADAPTABLE_MCP_CACHE_DIR` | `$XDG_CACHE_HOME/adaptable-mcp` or `~/.cache/adaptable-mcp` | Cache for docs, packages and bundled entries |
+| `ADAPTABLE_MCP_DOCS_HOST` | matched docs site | Docs site to read instead of the default one |
+| `ADAPTABLE_MCP_ADAPTABLE_SRC` | | AdapTable source folder (`packages/adaptable`) instead of the installed package (development) |
+
+## Development
+
+```bash
+npm install
+npm run build
+npm run lint
+npm test
+npm run inspect   # MCP Inspector against dist/bin.js mcp
+```
+
+Tests that exercise the AdapTable engine bundle `packages/adaptable/{aql,upgrade}.ts` from source, so build `packages/aql` and install `packages/adaptable`'s dependencies first. The layout, the boundary rule between `src/core` and the two transports, and the task list are in `design_docs/ai-tooling-v2/`.

package/data/manifest.snapshot.json

@@ -0,0 +1,184 @@
+{
+  "schemaVersion": 2,
+  "adaptableVersion": "24.0.0-canary.8",
+  "major": 24,
+  "agGridPeer": ">=36.2.0",
+  "agGridPairings": [
+    {
+      "adaptableVersion": "24",
+      "agGridMajor": 36,
+      "agGridVersion": "36.2.0"
+    },
+    {
+      "adaptableVersion": "23.1",
+      "agGridMajor": 36,
+      "agGridVersion": "36.2.0"
+    },
+    {
+      "adaptableVersion": "22",
+      "agGridMajor": 35,
+      "agGridVersion": "35.0.0"
+    },
+    {
+      "adaptableVersion": "21",
+      "agGridMajor": 34,
+      "agGridVersion": "34.0.0"
+    },
+    {
+      "adaptableVersion": "20",
+      "agGridMajor": 33,
+      "agGridVersion": "33.0.0"
+    },
+    {
+      "adaptableVersion": "19",
+      "agGridMajor": 32,
+      "agGridVersion": "32.1.0"
+    },
+    {
+      "adaptableVersion": "18",
+      "agGridMajor": 31,
+      "agGridVersion": "31.0.0"
+    },
+    {
+      "adaptableVersion": "16",
+      "agGridMajor": 30,
+      "agGridVersion": "30.0.0"
+    },
+    {
+      "adaptableVersion": "15",
+      "agGridMajor": 29,
+      "agGridVersion": "29.0.0"
+    },
+    {
+      "adaptableVersion": "13",
+      "agGridMajor": 28,
+      "agGridVersion": "28.1.0"
+    },
+    {
+      "adaptableVersion": "11",
+      "agGridMajor": 27,
+      "agGridVersion": "27.0.0"
+    },
+    {
+      "adaptableVersion": "10",
+      "agGridMajor": 26,
+      "agGridVersion": "26.0.0"
+    },
+    {
+      "adaptableVersion": "9",
+      "agGridMajor": 25,
+      "agGridVersion": "25.3.0"
+    },
+    {
+      "adaptableVersion": "8",
+      "agGridMajor": 24,
+      "agGridVersion": "24.1.0"
+    },
+    {
+      "adaptableVersion": "7.1",
+      "agGridMajor": 23,
+      "agGridVersion": "23.0.0"
+    },
+    {
+      "adaptableVersion": "7",
+      "agGridMajor": 22,
+      "agGridVersion": "22.0.0"
+    }
+  ],
+  "environment": {
+    "21": {
+      "node": ">=18",
+      "typescript": ">=5.4",
+      "react": ">=18",
+      "angular": ">=17.3",
+      "vue": ">=3"
+    },
+    "22": {
+      "node": ">=18",
+      "typescript": ">=5.5",
+      "react": ">=18",
+      "angular": ">=18.2.14",
+      "vue": ">=3"
+    },
+    "23": {
+      "node": ">=20",
+      "typescript": ">=5.5.4",
+      "react": ">=18",
+      "angular": ">=20",
+      "vue": ">=3"
+    },
+    "24": {
+      "node": ">=20",
+      "typescript": ">=5.5.4",
+      "react": ">=18",
+      "angular": ">=20",
+      "vue": ">=3"
+    }
+  },
+  "wrappers": {
+    "21": {
+      "react": "@adaptabletools/adaptable-react-aggrid",
+      "angular": "@adaptabletools/adaptable-angular-aggrid",
+      "vue": "@adaptabletools/adaptable-vue3-aggrid"
+    },
+    "22": {
+      "react": "@adaptabletools/adaptable-react-aggrid",
+      "angular": "@adaptabletools/adaptable-angular-aggrid",
+      "vue": "@adaptabletools/adaptable-vue3-aggrid"
+    },
+    "23": {
+      "react": "@adaptabletools/adaptable-react-aggrid",
+      "angular": "@adaptabletools/adaptable-angular-aggrid",
+      "vue": "@adaptabletools/adaptable-vue3-aggrid"
+    },
+    "24": {
+      "react": "@adaptabletools/adaptable-react-aggrid",
+      "angular": "@adaptabletools/adaptable-angular-aggrid",
+      "vue": "@adaptabletools/adaptable-vue3-aggrid"
+    }
+  },
+  "docsHosts": {
+    "21": "https://v21.adaptabletools.com",
+    "22": "https://v22.adaptabletools.com",
+    "23": "https://v23.adaptabletools.com",
+    "24": "https://www.adaptabletools.com"
+  },
+  "latest": {
+    "adaptableMajor": 24,
+    "requiredAgGrid": ">=36.2.0"
+  },
+  "cli": {
+    "minVersion": "1.0.0"
+  },
+  "frameworks": [
+    "vanilla",
+    "react",
+    "angular",
+    "vue"
+  ],
+  "baseUrl": "https://www.adaptabletools.com",
+  "builtAt": "2026-10-27T16:05:29.588Z",
+  "pageCount": 1195,
+  "files": {
+    "llmsTxt": {
+      "path": "/llms.txt",
+      "bytes": 122625,
+      "sha256": "4cae31d372353235cbcdf537c2d5275549017dfd899319fe39db19ac9f234b08"
+    },
+    "llmsFullTxt": {
+      "path": "/llms-full.txt",
+      "bytes": 25094299,
+      "sha256": "0279065daf3e462a46f1aaafbb99a0926b51580536ebdb48726760999f0a2370"
+    },
+    "pages": {
+      "path": "/llms/pages.json",
+      "bytes": 469761,
+      "sha256": "b0ee72b33e92f636ece17005e641fca54562e37add4dfcc6155413a27459cbf9"
+    },
+    "demos": {
+      "path": "/llms/demos.json",
+      "bytes": 224096,
+      "sha256": "003e62cafe8424ecdd65d28f94e6a22d410096b4b7fcf1d60208e7caf32a5bbc"
+    }
+  }
+}

package/dist/bin.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+// argv → `mcp` → src/mcp, else → src/cli (plan §5). Bare `adaptable` prints help;
+// it never starts the MCP server implicitly (plan §7.1).
+import { runCli } from './cli/index.js';
+import { runMcp } from './mcp/index.js';
+const argv = process.argv.slice(2);
+const io = {
+    stdout: (text) => {
+        process.stdout.write(text);
+    },
+    stderr: (text) => {
+        process.stderr.write(text);
+    },
+};
+process.exitCode = argv[0] === 'mcp' ? await runMcp(argv.slice(1), io) : await runCli(argv, io);
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,kFAAkF;AAClF,yDAAyD;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,EAAE,GAAG;IACT,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF,CAAC;AAEF,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC"}

package/dist/cli/build-commands.js

@@ -0,0 +1,200 @@
+/**
+ * Registry → commander tree (plan §6.1, §7.1). Every command, positional and
+ * option is derived from the capabilities' zod schemas, so the CLI, the MCP
+ * tools and `--help --json` cannot drift from each other.
+ */
+import { Command, InvalidArgumentError, Option } from 'commander';
+import { z } from 'zod';
+import { CLI_PACKAGE, CLI_RANGE, CLI_VERSION, SCHEMA_VERSION, listCapabilities, } from '../core/index.js';
+/** Global flags (plan §7.1); `--json` and `--quiet` are rendering flags the CLI owns */
+export const GLOBAL_FLAGS = [
+    ['--cwd <dir>', 'Project folder; defaults to the current directory'],
+    ['--major <n>', 'AdapTable major to assume instead of detecting it'],
+    ['--framework <fw>', 'Framework to assume instead of detecting it (vanilla, react, angular, vue)'],
+    ['--offline', 'Never touch the network; use caches and bundled snapshots'],
+    ['--quiet', 'Markdown output without warnings and info issues'],
+    ['--json', 'Print the response envelope as JSON'],
+    ['--docs-host <url>', 'Docs host to read instead of the default one'],
+];
+export const GLOBAL_KEYS = ['cwd', 'major', 'framework', 'offline', 'quiet', 'json', 'docsHost'];
+export function inputJsonSchema(schema) {
+    return z.toJSONSchema(schema, { io: 'input', unrepresentable: 'any' });
+}
+export function outputJsonSchema(schema) {
+    return z.toJSONSchema(schema, { io: 'output', unrepresentable: 'any' });
+}
+const kebab = (name) => name.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`);
+function propertyType(prop) {
+    if (prop.anyOf) {
+        const types = prop.anyOf.map(propertyType).filter((t) => t && t !== 'null');
+        return types[0];
+    }
+    return Array.isArray(prop.type) ? prop.type.find((t) => t !== 'null') : prop.type;
+}
+function parseNumber(value) {
+    const number = Number(value);
+    if (!Number.isFinite(number) || value.trim() === '') {
+        throw new InvalidArgumentError('Expected a number.');
+    }
+    return number;
+}
+function parseJson(value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        throw new InvalidArgumentError('Expected JSON.');
+    }
+}
+function parserFor(prop) {
+    switch (propertyType(prop)) {
+        case 'number':
+        case 'integer':
+            return parseNumber;
+        case 'object':
+            return parseJson;
+        default:
+            return undefined;
+    }
+}
+/** Adds the capability's positionals and options to a leaf command */
+function bindInput(command, capability) {
+    const schema = inputJsonSchema(capability.input);
+    const properties = schema.properties ?? {};
+    const required = new Set(schema.required ?? []);
+    const positionals = capability.cli.positionals ?? [];
+    positionals.forEach((field, index) => {
+        const prop = properties[field] ?? {};
+        const variadic = propertyType(prop) === 'array';
+        if (variadic && index !== positionals.length - 1) {
+            throw new Error(`Capability "${capability.name}": only the last positional ("${field}") may be an array.`);
+        }
+        const parser = parserFor(variadic && prop.items ? prop.items : prop);
+        const name = `${required.has(field) ? '<' : '['}${field}${variadic ? '...' : ''}${required.has(field) ? '>' : ']'}`;
+        if (parser && variadic) {
+            command.argument(name, prop.description ?? '', (value, previous = []) => [...previous, parser(value)]);
+        }
+        else if (parser) {
+            command.argument(name, prop.description ?? '', parser);
+        }
+        else {
+            command.argument(name, prop.description ?? '');
+        }
+    });
+    for (const [field, prop] of Object.entries(properties)) {
+        if (positionals.includes(field)) {
+            continue;
+        }
+        const flag = `--${kebab(field)}`;
+        const type = propertyType(prop);
+        const description = prop.description ?? '';
+        if (type === 'boolean') {
+            command.addOption(new Option(flag, description));
+            continue;
+        }
+        const value = type === 'array' ? `<${field}...>` : `<${field}>`;
+        const option = new Option(`${flag} ${value}`, description);
+        if (prop.enum?.every((v) => typeof v === 'string')) {
+            option.choices(prop.enum);
+        }
+        const parser = parserFor(type === 'array' && prop.items ? prop.items : prop);
+        if (parser && type === 'array') {
+            option.argParser((value, previous = []) => [...previous, parser(value)]);
+        }
+        else if (parser) {
+            option.argParser(parser);
+        }
+        if (required.has(field)) {
+            option.makeOptionMandatory();
+        }
+        command.addOption(option);
+    }
+}
+function groupCommand(parent, word) {
+    const existing = parent.commands.find((c) => c.name() === word);
+    if (existing) {
+        return existing;
+    }
+    const group = parent.command(word).description(`${word} commands`);
+    group.copyInheritedSettings(parent);
+    return group;
+}
+/** The commander program for the current registry */
+export function buildProgram(options) {
+    const program = new Command('adaptable')
+        .description('AdapTable CLI for coding agents: version-matched docs, State and AdapTableQL checks, migration, scaffolding')
+        .version(CLI_VERSION, '-v, --version', 'Print the CLI version')
+        .option('--capabilities', 'List the capabilities this version supports')
+        .exitOverride()
+        .configureOutput({ writeOut: options.writeOut, writeErr: options.writeErr })
+        .showHelpAfterError('(add --help for usage; --help --json prints the full contract)')
+        .addHelpText('after', `\nPackage: ${CLI_PACKAGE}@${CLI_RANGE} · schema ${SCHEMA_VERSION} · \`adaptable mcp\` starts the MCP server`);
+    for (const [flags, description] of GLOBAL_FLAGS) {
+        program.option(flags, description);
+    }
+    for (const capability of listCapabilities({ includeHidden: true })) {
+        const words = capability.cli.command;
+        let parent = program;
+        for (const word of words.slice(0, -1)) {
+            parent = groupCommand(parent, word);
+        }
+        const leaf = parent
+            .command(words[words.length - 1], { hidden: capability.hidden })
+            .description(capability.description);
+        leaf.copyInheritedSettings(parent);
+        bindInput(leaf, capability);
+        leaf.action(async (...args) => {
+            const command = args[args.length - 1];
+            const leafOptions = args[args.length - 2];
+            const positionalValues = args.slice(0, -2);
+            const input = {};
+            (capability.cli.positionals ?? []).forEach((field, i) => {
+                if (positionalValues[i] !== undefined) {
+                    input[field] = positionalValues[i];
+                }
+            });
+            for (const [key, value] of Object.entries(leafOptions)) {
+                if (value !== undefined) {
+                    input[key] = value;
+                }
+            }
+            const all = command.optsWithGlobals();
+            const globals = {};
+            for (const key of GLOBAL_KEYS) {
+                if (all[key] !== undefined) {
+                    globals[key] = key === 'major' ? parseNumber(String(all[key])) : all[key];
+                }
+            }
+            await options.onInvoke({ capability, input, globals });
+        });
+    }
+    return program;
+}
+/** `adaptable --help --json`: the full contract, used by the docs command-reference page */
+export function helpContract() {
+    return {
+        cliVersion: CLI_VERSION,
+        schemaVersion: SCHEMA_VERSION,
+        package: CLI_PACKAGE,
+        range: CLI_RANGE,
+        globalOptions: GLOBAL_FLAGS.map(([flags, description]) => ({ flags, description })),
+        exitCodes: { 0: 'ok / no findings', 1: 'findings', 2: 'usage', 3: 'environment' },
+        capabilities: listCapabilities().map((capability) => ({
+            name: capability.name,
+            description: capability.description,
+            cli: capability.cli,
+            mcp: capability.mcp,
+            input: inputJsonSchema(capability.input),
+            output: outputJsonSchema(capability.output),
+        })),
+    };
+}
+/** `adaptable --capabilities`: what this version supports, for skills that must not improvise a missing capability */
+export function capabilitiesReport() {
+    return {
+        cliVersion: CLI_VERSION,
+        schemaVersion: SCHEMA_VERSION,
+        capabilities: listCapabilities().map(({ name, cli, mcp }) => ({ name, cli, mcp })),
+    };
+}
+//# sourceMappingURL=build-commands.js.map

package/dist/cli/build-commands.js.map

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

package/dist/cli/index.js

@@ -0,0 +1,86 @@
+/**
+ * CLI entry: parses argv with the generated commander tree, runs the capability
+ * through core, renders the envelope and returns the exit code (plan §7.1).
+ * Writes only through `io`, so tests run it in-process.
+ */
+import { CommanderError } from 'commander';
+import { exitCodeFor, runCapability } from '../core/index.js';
+import { buildProgram, capabilitiesReport, helpContract } from './build-commands.js';
+import { renderEnvelope } from './render.js';
+const usageEnvelope = (message, hint) => ({
+    schemaVersion: 1,
+    ok: false,
+    error: { code: 'USAGE', message, hint },
+});
+function emit(io, envelope, globals, capability) {
+    const text = renderEnvelope(envelope, { json: globals.json, quiet: globals.quiet, capability });
+    if (globals.json || envelope.ok) {
+        io.stdout(text);
+    }
+    else {
+        io.stderr(text);
+    }
+    return exitCodeFor(envelope);
+}
+function capabilitiesMarkdown() {
+    const report = capabilitiesReport();
+    const rows = report.capabilities.map((c) => `| \`${c.name}\` | \`adaptable ${c.cli.command.join(' ')}\` | ${c.mcp ? `\`${c.mcp.tool}\`` : '—'} |`);
+    return [
+        `adaptable ${report.cliVersion} · schema ${report.schemaVersion}`,
+        '',
+        '| Capability | CLI | MCP tool |',
+        '| --- | --- | --- |',
+        ...rows,
+        '',
+    ].join('\n');
+}
+/** Runs the CLI for `argv` (without node and script) and returns the exit code */
+export async function runCli(argv, io) {
+    const wantsJson = argv.includes('--json');
+    if (argv.includes('--help') && wantsJson) {
+        io.stdout(`${JSON.stringify(helpContract(), null, 2)}\n`);
+        return 0;
+    }
+    if (argv.includes('--capabilities')) {
+        io.stdout(wantsJson ? `${JSON.stringify(capabilitiesReport(), null, 2)}\n` : capabilitiesMarkdown());
+        return 0;
+    }
+    let exitCode = 0;
+    const program = buildProgram({
+        writeOut: io.stdout,
+        writeErr: io.stderr,
+        onInvoke: async ({ capability, input, globals }) => {
+            const envelope = await runCapability(capability.name, input, {
+                cwd: globals.cwd,
+                major: globals.major,
+                framework: globals.framework,
+                offline: globals.offline,
+                docsHost: globals.docsHost,
+            });
+            exitCode = emit(io, envelope, globals, capability);
+        },
+    });
+    if (!argv.length) {
+        io.stdout(program.helpInformation());
+        return 0;
+    }
+    try {
+        await program.parseAsync(argv, { from: 'user' });
+        return exitCode;
+    }
+    catch (error) {
+        if (error instanceof CommanderError) {
+            if (error.code === 'commander.helpDisplayed' || error.code === 'commander.version' || error.code === 'commander.help') {
+                return 0;
+            }
+            if (wantsJson) {
+                io.stdout(renderEnvelope(usageEnvelope(error.message.trim(), 'Run `adaptable --help` or `adaptable --help --json`.'), {
+                    json: true,
+                }));
+            }
+            return 2;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/render.js

@@ -0,0 +1,57 @@
+const cell = (value) => value === undefined || value === null ? '' : String(value).replace(/\|/g, '\\|').replace(/\n/g, ' ');
+function issueLocation(issue) {
+    if (issue.file) {
+        return `${issue.file}${issue.line !== undefined ? `:${issue.line}${issue.column !== undefined ? `:${issue.column}` : ''}` : ''}`;
+    }
+    return issue.path ?? '';
+}
+export function renderIssues(issues) {
+    if (!issues.length) {
+        return '';
+    }
+    const rows = issues.map((issue) => `| ${issue.severity} | \`${cell(issue.code)}\` | ${cell(issueLocation(issue))} | ${cell(issue.message)}${issue.fix ? ` — ${cell(issue.fix)}` : ''} |`);
+    return ['| Severity | Rule | Where | Message |', '| --- | --- | --- | --- |', ...rows].join('\n');
+}
+export function renderContext(context) {
+    const version = context.adaptableVersion ?? (context.adaptableMajor !== undefined ? `${context.adaptableMajor}.x` : 'unknown');
+    const parts = [`AdapTable ${version} (${context.source})`];
+    if (context.framework) {
+        parts.push(context.framework);
+    }
+    if (context.agGridVersion) {
+        parts.push(`AG Grid ${context.agGridVersion}`);
+    }
+    parts.push(`code: ${context.codeSource}${context.engine ? `, engine ${context.engine.version} (${context.engine.source})` : ''}`);
+    parts.push(`docs: ${context.docsHost}`);
+    return parts.join(' · ');
+}
+function renderOk(envelope, options) {
+    const blocks = [];
+    if (envelope.resolvedContext) {
+        blocks.push(`_${renderContext(envelope.resolvedContext)}_`);
+    }
+    if (!options.quiet && envelope.warnings.length) {
+        blocks.push(envelope.warnings.map((warning) => `> **Warning:** ${warning}`).join('\n>\n'));
+    }
+    const issues = options.quiet ? envelope.issues.filter((issue) => issue.severity !== 'info') : envelope.issues;
+    if (issues.length) {
+        blocks.push(`## Issues (${issues.length})\n\n${renderIssues(issues)}`);
+    }
+    const body = options.capability?.markdown
+        ? options.capability.markdown(envelope.data, envelope)
+        : `\`\`\`json\n${JSON.stringify(envelope.data, null, 2)}\n\`\`\``;
+    if (body.trim()) {
+        blocks.push(body.trim());
+    }
+    return `${blocks.join('\n\n')}\n`;
+}
+export function renderEnvelope(envelope, options = {}) {
+    if (options.json) {
+        return `${JSON.stringify(envelope, null, 2)}\n`;
+    }
+    if (!envelope.ok) {
+        return `**Error ${envelope.error.code}:** ${envelope.error.message}\n\n${envelope.error.hint}\n`;
+    }
+    return renderOk(envelope, options);
+}
+//# sourceMappingURL=render.js.map