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

package/README.md

@@ -1,96 +1,91 @@
-# AdapTable MCP Server
+# @adaptabletools/adaptable-mcp
 
-An [MCP](https://modelcontextprotocol.io) server that helps coding agents write correct [AdapTable](https://www.adaptabletools.com) code for the version a project actually uses.
+One package, two modes, for coding agents working on [AdapTable](https://www.adaptabletools.com) projects:
 
-It looks things up and checks them; the agent still writes the code:
+- **`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.
 
-- detects the project's AdapTable, framework and AG Grid versions, and flags setup mistakes
-- searches the docs for that version and framework
-- validates AdapTableQL expressions and Initial State with the installed AdapTable package
-- migrates expressions and state from older versions
+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.
 
-For AG Grid itself (column definitions, AG Grid modules, row models, grid API), use AG Grid's [ag-mcp](https://www.ag-grid.com/javascript-data-grid/mcp-server/) alongside this server.
+Requires Node 20+. Full guide: [getting-started-ai-cli](https://www.adaptabletools.com/docs/getting-started-ai-cli).
 
-## Setup
+> 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.
 
-Requires Node 20+. The checks need AdapTable 24 or later installed in the project.
+## Skills first
 
-Cursor (`.cursor/mcp.json`) and other clients that take an `mcpServers` map:
+Install the AdapTable Agent Skills into a project; they tell the agent when to run the CLI and how to read its output:
 
-```json
-{
-  "mcpServers": {
-    "adaptable": {
-      "command": "npx",
-      "args": ["-y", "@adaptabletools/adaptable-mcp"]
-    }
-  }
-}
+```bash
+npx skills add https://www.adaptabletools.com
 ```
 
-Claude Code:
+Nothing else is required: the skills invoke `npx -y @adaptabletools/adaptable-mcp@^1 …` on demand.
+
+## The CLI
 
 ```bash
-claude mcp add adaptable -- npx -y @adaptabletools/adaptable-mcp
+npx -y @adaptabletools/adaptable-mcp@^1 <command> [options]
 ```
 
-The server finds the project from the client's workspace roots, then the current directory. Pass `projectPath` to any tool, or set `ADAPTABLE_MCP_PROJECT`, to point it elsewhere.
+| 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:
 
-## Tools
+```bash
+npm i -D @adaptabletools/adaptable-mcp
+npx adaptable cache add 24   # for machines without registry access later
+```
 
-| Tool | What it does |
-| --- | --- |
-| `detect_environment` | AdapTable and AG Grid packages, framework, peer range, documented AG Grid pairing, warnings |
-| `search_docs` | Docs sections for the project's version and framework, with URLs |
-| `get_doc` | One docs page (or one section of it) as markdown |
-| `check_expression` | Validates an AdapTableQL expression: syntax, functions, types, aggregation rules, the functions its Module offers, columns |
-| `migrate_expression` | Rewrites a pre-v24 expression to v24 syntax |
-| `list_expression_functions` | Built-in AdapTableQL functions with signatures and examples |
-| `check_state` | Initial State: type check against the installed `InitialState`, pre-v24 shapes, Layouts, column references, embedded expressions |
-| `migrate_state` | Upgrades state from an older major version (`AdaptableUpgradeHelper`) |
+## The MCP server
 
-Resources: `adaptable://docs/{major}/{slug}`, `adaptable://api/{major}/{typeName}`, `adaptable://aql/functions`.
+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"] }
+  }
+}
+```
 
-Prompts: `setup-adaptable` (framework), `upgrade-adaptable` (from, to).
+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`, `/llms-full.txt` and `/llms/pages.json`. The server picks the site that matches the project's major version (`www` for the latest major, `v{major}` for older ones, `canary` for a major that only has canary releases), caches the files, and re-downloads only when the manifest hash changes.
-- Checks use the `@adaptabletools/adaptable/aql` and `@adaptabletools/adaptable/upgrade` entry points of the installed package, so they match the project's exact version. The package ships as bundler ESM, so each entry is bundled once with esbuild and cached.
+- 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_PROJECT` | workspace root | Project to inspect |
-| `ADAPTABLE_MCP_DOCS_URL` | matched docs site | Docs site to read, e.g. `https://dev.adaptabletools.com` |
-| `ADAPTABLE_MCP_DOCS_DIR` | | Local docs build (`documentation/public`) instead of a site |
-| `ADAPTABLE_MCP_ADAPTABLE_SRC` | | AdapTable source folder (`packages/adaptable`) instead of the installed package |
-| `ADAPTABLE_MCP_CACHE_DIR` | `~/.cache/adaptable-mcp` | Cache for docs and bundled entries |
+| `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
-```
-
-### Eval
-
-`eval/tasks.json` holds the eval tasks: setup per framework, AdapTableQL, state, option placement and upgrades. `eval/grade.mjs` grades a folder of answers (`<task-id>.md`), checking expressions and Initial State (including the type check) with the same code as the tools.
-
-`npm test` checks the checks in both directions: every Initial State in the docs demos must pass `check_state` (`test/docsExamples.test.mjs`; known docs issues are listed there until the demos are fixed), and every answer in `eval/known-wrong` (stale answers from a run without the MCP) must fail grading.
-
-Eval runs write their answers to `eval/results/<run>/` (gitignored):
-
-```bash
-node eval/grade.mjs eval/results/baseline
+npm run inspect   # MCP Inspector against dist/bin.js mcp
 ```
 
-`eval/mcp-call.mjs` calls one tool from the command line, for agents that run the eval without MCP support:
-
-```bash
-ADAPTABLE_MCP_PROJECT=eval/fixture node eval/mcp-call.mjs search_docs '{"query":"pivot layout"}'
-```
+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