@acid-cat/cli 0.2.0 → 0.3.1

package/conformance/fixture.acidcat.json

@@ -1,6 +1,7 @@
 {
   "acidcat": "0.1",
   "title": "AcidCat conformance fixture",
+  "description": "One capability for each behavior that acid-cat conform tests.",
   "targets": {
     "api": {
       "bindings": [
@@ -66,6 +67,72 @@
       },
       "readOnly": true
     },
+    "fixture.flags": {
+      "description": "Return the input. The input has one property for each kind of command-line flag.",
+      "audience": [
+        "cli"
+      ],
+      "input": {
+        "properties": {
+          "count": {
+            "type": "integer"
+          },
+          "extra": {
+            "type": "object"
+          },
+          "label": {
+            "type": "string"
+          },
+          "mode": {
+            "enum": [
+              "fast",
+              "slow"
+            ],
+            "type": "string"
+          },
+          "ratio": {
+            "type": "number"
+          },
+          "verbose": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "mode"
+        ],
+        "type": "object"
+      },
+      "output": {
+        "properties": {
+          "count": {
+            "type": "integer"
+          },
+          "extra": {
+            "type": "object"
+          },
+          "label": {
+            "type": "string"
+          },
+          "mode": {
+            "enum": [
+              "fast",
+              "slow"
+            ],
+            "type": "string"
+          },
+          "ratio": {
+            "type": "number"
+          },
+          "verbose": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "mode"
+        ],
+        "type": "object"
+      }
+    },
     "fixture.hidden": {
       "description": "Only the app target can use this capability.",
       "audience": [
@@ -146,7 +213,11 @@
         "mcp",
         "cli",
         "api"
-      ]
+      ],
+      "input": {
+        "properties": {},
+        "type": "object"
+      }
     }
   }
 }

package/dist/conform/cli.js

@@ -3,6 +3,16 @@ import { spawn } from "node:child_process";
 //#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";
+/** The `usage` of each capability in the view of the fixture, after the name of the program. */
+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.refuse": "fixture refuse",
+	"fixture.slow": "fixture slow --milliseconds <number>",
+	"fixture.switch.set": "fixture switch set --on",
+	"fixture.toggle": "fixture toggle"
+};
 /** The time that a command line has to start before the interrupt, in milliseconds. */
 const INTERRUPT_AFTER = 2e3;
 /** Run the command line. If `interruptAfter` is given, send `SIGINT` after that many milliseconds. */
@@ -106,6 +116,15 @@ async function checkCli(command) {
 		const result = await cli("list");
 		expectEqual(sorted(JSON.parse(result.stdout).map((entry) => entry.id)), idsOf("cli"), "ids");
 	});
+	await checks.run("list gives the usage of each capability, with its flags", `${RULE}#commands`, async () => {
+		const entries = JSON.parse((await cli("list")).stdout);
+		for (const { id, usage } of entries) {
+			expect(typeof usage === "string", `${id} must have a usage`);
+			const [program, ...rest] = usage.split(" ");
+			expect(program !== "" && rest.length > 0, `the usage of ${id} must start with the name of the program, got ${JSON.stringify(usage)}`);
+			expectEqual(rest.join(" "), USAGES[id], `usage of ${id} after the name of the program`);
+		}
+	});
 	return checks;
 }
 //#endregion

package/dist/conform/mcp.js

@@ -1,4 +1,4 @@
-import { Checks, FORBIDDEN_ORIGIN, expect, expectEqual, idsOf, sorted } from "./check.js";
+import { Checks, FORBIDDEN_ORIGIN, expect, expectEqual, fixture, idsOf, sorted } from "./check.js";
 import { Client, StreamableHTTPClientTransport } from "@modelcontextprotocol/client";
 //#region src/conform/mcp.ts
 /**
@@ -28,6 +28,9 @@ async function checkMcp(url, options) {
 		name,
 		arguments: args
 	});
+	await checks.run("server/discover gives the description of the catalog as instructions", `${RULE}#server`, () => {
+		expectEqual(mcp.getInstructions(), fixture.description, "instructions");
+	});
 	await checks.run("tools/list gives each available capability of the view", `${RULE}#tools`, async () => {
 		const { tools } = await mcp.listTools();
 		expectEqual(sorted(tools.map((tool) => tool.name)), idsOf("mcp"), "tools");

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

@@ -2,6 +2,7 @@
 var fixture_acidcat_default = {
 	acidcat: "0.1",
 	title: "AcidCat conformance fixture",
+	description: "One capability for each behavior that acid-cat conform tests.",
 	targets: {
 		"api": { "bindings": ["http"] },
 		"app": { "bindings": ["typescript", "webmcp"] },
@@ -38,6 +39,40 @@ var fixture_acidcat_default = {
 			},
 			"readOnly": true
 		},
+		"fixture.flags": {
+			"description": "Return the input. The input has one property for each kind of command-line flag.",
+			"audience": ["cli"],
+			"input": {
+				"properties": {
+					"count": { "type": "integer" },
+					"extra": { "type": "object" },
+					"label": { "type": "string" },
+					"mode": {
+						"enum": ["fast", "slow"],
+						"type": "string"
+					},
+					"ratio": { "type": "number" },
+					"verbose": { "type": "boolean" }
+				},
+				"required": ["mode"],
+				"type": "object"
+			},
+			"output": {
+				"properties": {
+					"count": { "type": "integer" },
+					"extra": { "type": "object" },
+					"label": { "type": "string" },
+					"mode": {
+						"enum": ["fast", "slow"],
+						"type": "string"
+					},
+					"ratio": { "type": "number" },
+					"verbose": { "type": "boolean" }
+				},
+				"required": ["mode"],
+				"type": "object"
+			}
+		},
 		"fixture.hidden": {
 			"description": "Only the app target can use this capability.",
 			"audience": ["app"]
@@ -97,7 +132,11 @@ var fixture_acidcat_default = {
 				"mcp",
 				"cli",
 				"api"
-			]
+			],
+			"input": {
+				"properties": {},
+				"type": "object"
+			}
 		}
 	}
 };

package/dist/json/package.json.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acid-cat/cli",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "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.2.0",
-    "@acid-cat/spec-ts": "0.2.0",
+    "@acid-cat/catalog": "0.3.1",
+    "@acid-cat/spec-ts": "0.3.1",
     "@effect/platform-node": "4.0.4",
     "@effect/platform-node-shared": "4.0.4",
     "@modelcontextprotocol/client": "2.3.1",