@acid-cat/cli 0.6.1 → 0.8.0

package/README.md

@@ -35,7 +35,7 @@ The exit code is 0 if there are no errors. It is 1 if there are errors. With `--
 `conform` tests a running implementation of the [conformance fixture](conformance/fixture.pkl) through its bindings (see [Conformance](../../spec/conformance.md#acid-cat-conform)):
 
 - **MCP:** the official MCP client, with revision `2026-07-28`, for tools and outcomes; raw requests for rejections.
-- **HTTP** and **CLI:** each outcome, each kind of call failure, availability, and rejections. For the CLI, an interrupt (`SIGINT`) during a call that holds gives exit code 130.
+- **HTTP** and **CLI:** each outcome, each kind of call failure, availability, and rejections. For the CLI, also each kind of flag, including a repeated flag that gives one item of an array for each occurrence, or the whole array as JSON text, and the usage line of each command. An interrupt (`SIGINT`) during a call that holds gives exit code 130.
 - **WebMCP:** the checks act as the WebMCP host. `--webmcp <url>` opens a page that serves the `app` target in Chromium, through [Playwright](https://playwright.dev), with a test `modelContext`. Install Playwright to use it: `pnpm add -D playwright`, then `pnpm exec playwright install chromium`. In code, `webmcp` can also be a function that installs the implementation on a host in the same process.
 - **Properties:** with fast-check, through each remote binding: concurrent calls each get exactly their own outcome, and a cancellation changes only its own call.
 

package/conformance/fixture.acidcat.json

@@ -93,6 +93,18 @@
           "ratio": {
             "type": "number"
           },
+          "steps": {
+            "items": {
+              "type": "integer"
+            },
+            "type": "array"
+          },
+          "tags": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
           "verbose": {
             "type": "boolean"
           }
@@ -123,6 +135,18 @@
           "ratio": {
             "type": "number"
           },
+          "steps": {
+            "items": {
+              "type": "integer"
+            },
+            "type": "array"
+          },
+          "tags": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
           "verbose": {
             "type": "boolean"
           }

package/dist/conform/cli.js

@@ -5,6 +5,7 @@ import { existsSync } from "node:fs";
 import { mkdtemp, rm } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
+import { isDeepStrictEqual } from "node:util";
 //#region src/conform/cli.ts
 /** Conformance checks for the CLI binding (spec/bindings/cli.md). Each check runs the command line as a process. */
 const RULE = "spec/bindings/cli.md";
@@ -12,7 +13,7 @@ const RULE = "spec/bindings/cli.md";
 const USAGES = {
 	"fixture.crash": "fixture crash",
 	"fixture.echo": "fixture echo --text <string>",
-	"fixture.flags": "fixture flags --mode <fast|slow> [--count <integer>] [--extra <json>] [--label <string>] [--ratio <number>] [--verbose]",
+	"fixture.flags": "fixture flags --mode <fast|slow> [--count <integer>] [--extra <json>] [--label <string>] [--ratio <number>] [--steps <integer>...] [--tags <string>...] [--verbose]",
 	"fixture.held": "fixture held",
 	"fixture.hold": "fixture hold --key <string> [--marker <string>]",
 	"fixture.refuse": "fixture refuse",
@@ -109,6 +110,32 @@ async function checkCli(command, options) {
 			],
 			3
 		],
+		[
+			"an item of a repeated flag that is not valid has exit code 3",
+			[
+				"fixture",
+				"flags",
+				"--mode",
+				"fast",
+				"--steps",
+				"1",
+				"--steps",
+				"soon"
+			],
+			3
+		],
+		[
+			"an item of a repeated flag as JSON text that is not valid has exit code 3",
+			[
+				"fixture",
+				"flags",
+				"--mode",
+				"fast",
+				"--steps",
+				"[1,\"soon\"]"
+			],
+			3
+		],
 		[
 			"invalid input through call has exit code 3",
 			[
@@ -148,6 +175,55 @@ async function checkCli(command, options) {
 			});
 		}
 	});
+	await checks.run("each flag gives the value of its property, and a repeated flag gives one item for each occurrence", `${RULE}#commands`, async (signal) => {
+		const scalars = [
+			"--mode",
+			"slow",
+			"--count",
+			"3",
+			"--ratio=0.5",
+			"--label",
+			"x",
+			"--verbose",
+			"--extra",
+			"{\"a\":1}"
+		];
+		const repeated = [
+			"--steps",
+			"2",
+			"--tags",
+			"[\"a\"]",
+			"--steps=1",
+			"--tags",
+			"b"
+		];
+		const result = await run(signal, "fixture", "flags", ...scalars, ...repeated);
+		expectEqual(result.code, 0, "exit code");
+		const expected = {
+			mode: "slow",
+			count: 3,
+			ratio: .5,
+			label: "x",
+			verbose: true,
+			extra: { a: 1 },
+			steps: [2, 1],
+			tags: ["[\"a\"]", "b"]
+		};
+		const output = parseJson(result.stdout);
+		expect(isDeepStrictEqual(output, expected), `standard output: expected ${JSON.stringify(expected)}, got ${JSON.stringify(output)}`);
+	});
+	await checks.run("a repeated flag that occurs once with JSON text of an array gives that array", `${RULE}#commands`, async (signal) => {
+		const result = await run(signal, "fixture", "flags", "--steps", "[2,1]", "--mode", "fast", "--verbose", "--tags=[\"a\",\"b\"]");
+		expectEqual(result.code, 0, "exit code");
+		const expected = {
+			mode: "fast",
+			verbose: true,
+			steps: [2, 1],
+			tags: ["a", "b"]
+		};
+		const output = parseJson(result.stdout);
+		expect(isDeepStrictEqual(output, expected), `standard output: expected ${JSON.stringify(expected)}, got ${JSON.stringify(output)}`);
+	});
 	await checks.run("call gives the value of a capability", `${RULE}#commands`, async (signal) => {
 		const result = await run(signal, "call", "fixture.echo", "{\"text\":\"hello\"}");
 		expectEqual(result.code, 0, "exit code");

package/dist/conform/index.d.ts

@@ -3,7 +3,7 @@ import type { WebMcpInstall } from "./webmcp.js";
 export type { Check } from "./check.js";
 export { DEADLINE, fixture } from "./check.js";
 export { serve } from "./serve.js";
-export type { Served, WebHandler } from "./serve.js";
+export type { Routes, Served, WebHandler } from "./serve.js";
 export { createTestHost } from "./webmcp.js";
 export type { TestHost, WebMcpInstall } from "./webmcp.js";
 export interface ConformOptions {

package/dist/conform/serve.d.ts

@@ -3,8 +3,10 @@ export interface Served {
     readonly url: string;
     close(): Promise<void>;
 }
-export type WebHandler = (request: Request) => Promise<Response>;
-/** Serve handlers by path prefix, for example `{ "/mcp": mcp, "/api": http }`. */
-export declare function serve(routes: {
+export type WebHandler = (request: Request) => Promise<Response> | Response;
+/** Handlers by path prefix, for example `{ "/mcp": mcp, "/api": http }`. The longest prefix that matches gets the request. */
+export interface Routes {
     readonly [prefix: string]: WebHandler;
-}): Promise<Served>;
+}
+/** Serve one handler for all paths, or handlers by path prefix, on `127.0.0.1` and a free port. */
+export declare function serve(handler: WebHandler | Routes): Promise<Served>;

package/dist/conform/serve.js

@@ -4,8 +4,9 @@ import { createServer } from "node:http";
 * Serve a web request handler, `(request: Request) => Promise<Response>`, on a local port. Implementations use it
 * to run `acid-cat conform` against their bindings in a test.
 */
-/** Serve handlers by path prefix, for example `{ "/mcp": mcp, "/api": http }`. */
-function serve(routes) {
+/** Serve one handler for all paths, or handlers by path prefix, on `127.0.0.1` and a free port. */
+function serve(handler) {
+	const routes = typeof handler === "function" ? { "/": handler } : handler;
 	const prefixes = Object.keys(routes).sort((a, b) => b.length - a.length);
 	const server = createServer((incoming, outgoing) => {
 		answer(incoming, outgoing, prefixes, routes);
@@ -22,7 +23,7 @@ function serve(routes) {
 }
 async function answer(incoming, outgoing, prefixes, routes) {
 	const url = new URL(incoming.url ?? "/", `http://${incoming.headers.host ?? "127.0.0.1"}`);
-	const prefix = prefixes.find((candidate) => url.pathname === candidate || url.pathname.startsWith(`${candidate}/`));
+	const prefix = prefixes.find((candidate) => candidate === "/" || url.pathname === candidate || url.pathname.startsWith(`${candidate}/`));
 	const handler = prefix === void 0 ? void 0 : routes[prefix];
 	if (handler === void 0) {
 		outgoing.writeHead(404).end();

package/dist/index.d.ts

@@ -2,4 +2,4 @@
 export { bundle, check, viewOf } from "./catalog.js";
 export type { Catalog, Report } from "./catalog.js";
 export { conform, fixture, serve } from "./conform/index.js";
-export type { Check, ConformOptions, Served, WebHandler } from "./conform/index.js";
+export type { Check, ConformOptions, Routes, Served, WebHandler } from "./conform/index.js";

package/dist/json/fixture.acidcat.json.js

@@ -52,6 +52,14 @@ var fixture_acidcat_default = {
 						"type": "string"
 					},
 					"ratio": { "type": "number" },
+					"steps": {
+						"items": { "type": "integer" },
+						"type": "array"
+					},
+					"tags": {
+						"items": { "type": "string" },
+						"type": "array"
+					},
 					"verbose": { "type": "boolean" }
 				},
 				"required": ["mode"],
@@ -67,6 +75,14 @@ var fixture_acidcat_default = {
 						"type": "string"
 					},
 					"ratio": { "type": "number" },
+					"steps": {
+						"items": { "type": "integer" },
+						"type": "array"
+					},
+					"tags": {
+						"items": { "type": "string" },
+						"type": "array"
+					},
 					"verbose": { "type": "boolean" }
 				},
 				"required": ["mode"],

package/dist/json/package.json.js

@@ -1,4 +1,4 @@
 //#region package.json
-var version = "0.6.1";
+var version = "0.8.0";
 //#endregion
 export { version };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acid-cat/cli",
-  "version": "0.6.1",
+  "version": "0.8.0",
   "description": "The AcidCat command line: check, format and view catalogs, and test implementations.",
   "keywords": [
     "acidcat",
@@ -37,8 +37,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@acid-cat/catalog": "0.6.1",
-    "@acid-cat/spec-ts": "0.6.1",
+    "@acid-cat/catalog": "0.8.0",
+    "@acid-cat/spec-ts": "0.8.0",
     "@effect/platform-node": "4.0.6",
     "@effect/platform-node-shared": "4.0.6",
     "@modelcontextprotocol/client": "2.3.1",