@jrpool/kilotest 39.0.3 → 40.0.0

package/api/requestFeature.js

@@ -12,13 +12,13 @@ const {sendAlert} = require('../alerts');
 
 // Returns the response body.
 exports.response = async args => {
-  const [request = ''] = args;
+  const [feature = ''] = args;
   // Initialize the response content.
   const responseContent = {
     'details about your request': null
   };
-  // If the request is empty:
-  if (!request) {
+  // If the requested feature or improvement is empty:
+  if (!feature) {
     // Add this to the response content.
     responseContent['details about your request'] = {
       error: 'request invalid: request is empty'
@@ -27,7 +27,7 @@ exports.response = async args => {
   // Otherwise, i.e. if it exists:
   else {
     // Notify the manager.
-    await sendAlert('MCP feature request received', request);
+    await sendAlert('MCP feature request received', feature);
     // Add the disposition to the response content.
     responseContent['details about your request'] = {
       'date and time received': new Date().toISOString(),
@@ -43,7 +43,7 @@ exports.response = async args => {
       method: 'POST',
       URL: `${thisHost}/api/requestFeature`,
       body: {
-        request
+        feature
       },
       'closest ancestor request': null
     },

package/api/routes.js

@@ -90,7 +90,7 @@ module.exports = [
     operationId: 'requestFeature',
     method: 'post',
     path: '/api/requestFeature',
-    summary: 'Request a new feature or feature improvement',
+    summary: 'Request a feature improvement or new feature',
     bodySchema: z.object(requestFeatureSchema),
     responseSchema: requestFeatureResponseSchema
   }

package/api/schemas.js

@@ -52,7 +52,7 @@ exports.requestRetestSchema = {
 
 // requestFeature: POST /api/requestFeature
 exports.requestFeatureSchema = {
-  request: z.string().describe('description of requested new feature or feature improvement')
+  feature: z.string().describe('description of requested feature improvement or new feature')
 };
 
 // listReports takes no input; omitted (mcp.js already uses inputSchema: {}).
@@ -105,11 +105,16 @@ const thisRequestSchema = (method, bodySchema) => z.object({
   'closest ancestor request': requestReferenceSchema.nullable()
 });
 
-const envelope = (method, responseContentSchema, bodySchema) => z.object({
+const envelope = (
+  method,
+  responseContentSchema,
+  bodySchema,
+  /** @type {z.ZodType} */ similarWebSchema = similarWebRequestsSchema
+) => z.object({
   'tool collection': toolsFactsSchema,
   'tool name': z.string(),
   'this request': thisRequestSchema(method, bodySchema),
-  'URLs of similar requests for web users': similarWebRequestsSchema,
+  'URLs of similar requests for web users': similarWebSchema,
   'response metadata': responseMetadataSchema,
   'response content': responseContentSchema
 });
@@ -293,5 +298,6 @@ exports.requestFeatureResponseSchema = envelope(
       disposition: z.string()
     })
   ])}),
-  z.object(exports.requestFeatureSchema)
+  z.object(exports.requestFeatureSchema),
+  z.null()
 );

package/api/testSuite.js

@@ -272,13 +272,17 @@ const requestService = async () => {
     return;
   }
   console.log('======================\nRequest: Make a feature request');
-  path = `/api/requestFeature/${timeStamp}/${jobID}`;
+  path = '/api/requestFeature';
+  const featureRequest = 'Do the impossible';
   body = await submitRequest(path, method, {
-    feature: 'Do the impossible'
+    feature: featureRequest
   });
-  responseContent = body?.['response content'] ?? {};
-  requestDetails = responseContent['details about your request'] ?? {};
-  if (!requestDetails.disposition?.includes('received and logged')) {
+  const feature = body?.['this request']?.body?.feature ?? {};
+  requestDetails = body?.['response content']?.['details about your request'] ?? {};
+  if (
+    feature !== featureRequest
+    || !requestDetails.disposition?.includes('received and logged')
+  ) {
     console.log(`requestDetails: ${JSON.stringify(requestDetails, null, 2)}`);
     return;
   }

package/index.js

@@ -750,10 +750,10 @@ const requestHandler = async (request, response) => {
           }
           // Otherwise, if the service is to receive a feature request:
           else if (segments[0] === 'requestFeature') {
-            const {request} = postData;
+            const {feature} = postData;
             // Get the response body.
             const responseBody = await require(path.join(__dirname, 'api', 'requestFeature'))
-            .response(segments.slice(1).concat(request));
+            .response([feature]);
             // Send it.
             setHeaders('application/json', null, 'ultra');
             response.end(JSON.stringify(responseBody));

package/openapi.yaml

@@ -2,7 +2,7 @@ openapi: 3.1.0
 info:
   title: Kilotest API
   description: 'Kilotest is an ensemble testing and reporting service for front-end web quality. It uses an ensemble of 10 rule engines to test public web pages for front-end quality (accessibility, usability, and standards conformity). Kilotest acts as a web server for human users, an MCP server for AI platforms, and an API for programmatic access. With this API you can request that a page be tested or retested, discover available reports, incrementally retrieve facts from a report: from what reports are available, to what issues were reported in one report, to what elements violated one issue, to what diagnoses rule engines gave for one violation.'
-  version: 39.0.0
+  version: 39.0.3
   license:
     name: MIT
     identifier: MIT
@@ -1045,21 +1045,21 @@ paths:
   /api/requestFeature:
     post:
       operationId: requestFeature
-      summary: Request a new feature or feature improvement
+      summary: Request a feature improvement or new feature
       requestBody:
         content:
           application/json:
             schema:
               type: object
               properties:
-                request:
+                feature:
                   type: string
-                  description: description of requested new feature or feature improvement
+                  description: description of requested feature improvement or new feature
               required:
-                - request
+                - feature
       responses:
         '200':
-          description: Request a new feature or feature improvement
+          description: Request a feature improvement or new feature
           content:
             application/json:
               schema:
@@ -1082,11 +1082,11 @@ paths:
                       body:
                         type: object
                         properties:
-                          request:
+                          feature:
                             type: string
-                            description: description of requested new feature or feature improvement
+                            description: description of requested feature improvement or new feature
                         required:
-                          - request
+                          - feature
                         additionalProperties: false
                       closest ancestor request:
                         anyOf:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jrpool/kilotest",
-  "version": "39.0.3",
+  "version": "40.0.0",
   "description": "Ensemble testing for front-end web quality",
   "main": "index.js",
   "scripts": {

package/scripts/generate-openapi.js

@@ -20,6 +20,7 @@ const outputPath = path.join(__dirname, '..', 'openapi.yaml');
 
 // Builds the paths object for createDocument from the route table.
 const buildPaths = () => {
+  /** @type {import('zod-openapi').ZodOpenApiPathsObject} */
   const paths = {};
   routes.forEach(route => {
     const {method, path: routePath, summary, pathParamsSchema, bodySchema, responseSchema} = route;

package/CLAUDE.md

@@ -1,5 +0,0 @@
-# Cascade Rules
-
-- Ask mode: If the current mode is Ask, answer questions and provide code, diffs, or edit suggestions in code blocks or as plain text. Do not invite the user to switch to Normal or Code mode or any mode that permits writing files.
-- Comply with the current convention to omit line breaks in long lines in `.md` files and in code comments.
-- In conversation responses (not files), when a Markdown table cell would contain a line longer than 120 characters divided by the number of columns, insert `<br>` tags to keep displayed line lengths shorter than that maximum, since raw newlines are not valid inside table cells. If this rule makes any table cumbersome, use a non-tabular format, such as a list, instead.