@jrpool/kilotest 46.0.6 → 46.0.7

package/index.js

@@ -861,6 +861,10 @@ const requestHandler = async (request, response) => {
   }
 };
 
+// EXPORTS
+
+exports.requestHandler = requestHandler;
+
 // SERVER
 
 const serve = async (protocolModule, options) => {
@@ -879,23 +883,25 @@ const serve = async (protocolModule, options) => {
 
 // EXECUTION
 
-if (protocol === 'http') {
-  console.log('Starting HTTP server');
-  serve(http, {});
-}
-else if (protocol === 'https') {
-  console.log('Starting HTTPS server');
-  fs.readFile(process.env.KEY, 'utf8')
-  .then(
-    key => {
-      fs.readFile(process.env.CERT, 'utf8')
-      .then(
-        cert => {
-          serve(https, {key, cert});
-        },
-        error => console.log(error.message)
-      );
-    },
-    error => console.log(error.message)
-  );
+if (require.main === module) {
+  if (protocol === 'http') {
+    console.log('Starting HTTP server');
+    serve(http, {});
+  }
+  else if (protocol === 'https') {
+    console.log('Starting HTTPS server');
+    fs.readFile(process.env.KEY, 'utf8')
+    .then(
+      key => {
+        fs.readFile(process.env.CERT, 'utf8')
+        .then(
+          cert => {
+            serve(https, {key, cert});
+          },
+          error => console.log(error.message)
+        );
+      },
+      error => console.log(error.message)
+    );
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jrpool/kilotest",
-  "version": "46.0.6",
+  "version": "46.0.7",
   "description": "Ensemble testing for front-end web quality",
   "main": "index.js",
   "engines": {
@@ -10,7 +10,6 @@
     "start": "node index",
     "lint": "npx eslint && npx markdownlint-cli2",
     "test": "c8 node --test",
-    "test:api": "node api/testSuite",
     "generate:openapi": "node scripts/generate-openapi"
   },
   "repository": {
@@ -49,6 +48,7 @@
     "globals": "*",
     "js-yaml": "*",
     "markdownlint-cli2": "*",
+    "node-html-parser": "*",
     "zod-openapi": "*"
   },
   "allowScripts": {

package/routing.test.js

@@ -0,0 +1,77 @@
+/*
+  routing.test.js
+  Integration tests for HTTP routing in index.js, verifying that POST-only API services reject GET requests.
+*/
+
+// IMPORTS
+
+const {test, before, after} = require('node:test');
+const assert = require('node:assert/strict');
+const path = require('node:path');
+const http = require('node:http');
+const {requestHandler} = require('./index');
+
+// CONSTANTS
+
+const port = 3999;
+
+// SETUP AND TEARDOWN
+
+const savedDBDir = process.env.DB_DIR;
+let server;
+
+before(async () => {
+  process.env.DB_DIR = path.join(__dirname, 'test', 'fixtures', 'db');
+  server = http.createServer(requestHandler);
+  await new Promise(resolve => server.listen(port, resolve));
+});
+
+after(async () => {
+  if (savedDBDir !== undefined) {
+    process.env.DB_DIR = savedDBDir;
+  }
+  else {
+    delete process.env.DB_DIR;
+  }
+  await new Promise(resolve => server.close(() => resolve()));
+});
+
+// HELPERS
+
+// Sends a GET request and returns the response body as a string.
+const get = requestPath => new Promise((resolve, reject) => {
+  http.request({method: 'GET', host: 'localhost', port, path: requestPath}, response => {
+    const chunks = [];
+    response.on('data', chunk => chunks.push(chunk));
+    response.on('end', () => {
+      resolve({statusCode: response.statusCode, body: chunks.join('')});
+    });
+  })
+  .on('error', reject)
+  .end();
+});
+
+// TESTS
+
+test('GET /api/requestTest returns an error, not a test-request response', async () => {
+  const result = await get('/api/requestTest');
+  assert.ok(result.body.includes('Invalid service request'));
+});
+
+test('GET /api/requestRetest returns an error, not a retest-request response', async () => {
+  const result = await get('/api/requestRetest/260101T0001/ct');
+  assert.ok(result.body.includes('Invalid service request'));
+});
+
+test('GET /api/requestFeature returns an error, not a feature-request response', async () => {
+  const result = await get('/api/requestFeature');
+  assert.ok(result.body.includes('Invalid service request'));
+});
+
+test('GET /api/listReports returns a valid JSON response', async () => {
+  const result = await get('/api/listReports');
+  const body = JSON.parse(result.body);
+  assert.equal(body['tool name'], 'listReports');
+  const reports = body['response content']['basics about all available reports'];
+  assert.equal(reports.length, 6);
+});

package/web/listDiagnoses/listDiagnoses.test.js

@@ -0,0 +1,74 @@
+/*
+  listDiagnoses.test.js
+  UI tests for web/listDiagnoses/index.js using the fixture corpus.
+*/
+
+// IMPORTS
+
+const {test, before, after} = require('node:test');
+const assert = require('node:assert/strict');
+const path = require('node:path');
+const {parse} = require('node-html-parser');
+const {answer} = require('./index');
+
+// SETUP AND TEARDOWN
+
+const savedDBDir = process.env.DB_DIR;
+
+before(() => {
+  process.env.DB_DIR = path.join(__dirname, '..', '..', 'test', 'fixtures', 'db');
+});
+
+after(() => {
+  if (savedDBDir !== undefined) {
+    process.env.DB_DIR = savedDBDir;
+  }
+  else {
+    delete process.env.DB_DIR;
+  }
+});
+
+// TESTS
+
+test('listDiagnoses returns an ok status with valid HTML for catalogIndex 0, linkNoText, in the mixed report', async () => {
+  const result = await answer('linkNoText/260101T0000/mix/0');
+  assert.equal(result.status, 'ok');
+  assert.ok(result.answerPage);
+  const html = parse(result.answerPage);
+  assert.ok(html.querySelector('title'));
+});
+
+test('listDiagnoses includes the issue summary in the HTML', async () => {
+  const result = await answer('linkNoText/260101T0000/mix/0');
+  assert.ok(result.answerPage.includes('link not named'));
+});
+
+test('listDiagnoses includes the element tag name and text from the catalog', async () => {
+  const result = await answer('linkNoText/260101T0000/mix/0');
+  assert.ok(result.answerPage.includes('About Us'));
+});
+
+test('listDiagnoses includes diagnosis descriptions from the rule engines', async () => {
+  const result = await answer('linkNoText/260101T0000/mix/0');
+  assert.ok(result.answerPage.includes('The link does not have an accessible name'));
+});
+
+test('listDiagnoses returns an error status for a hidden report', async () => {
+  const result = await answer('linkNoText/260101T0007/hid/0');
+  assert.equal(result.status, 'error');
+});
+
+test('listDiagnoses returns an error status for a nonexistent report', async () => {
+  const result = await answer('linkNoText/999999T9999/xyz/0');
+  assert.equal(result.status, 'error');
+});
+
+test('listDiagnoses returns ok with no diagnoses for a nonexistent catalog index', async () => {
+  const result = await answer('linkNoText/260101T0000/mix/999');
+  assert.equal(result.status, 'ok');
+  const html = parse(result.answerPage);
+  const diagnosisItems = html.querySelectorAll('li');
+  // The page may have other li elements, but none should contain diagnosis descriptions.
+  const diagnosisTexts = diagnosisItems.map(li => li.text);
+  assert.ok(!diagnosisTexts.some(t => t.includes('The link does not have an accessible name')));
+});

package/web/listIssues/index.js

@@ -64,9 +64,9 @@ const getIssuesData = async (timeStamp, jobID) => {
         const instances = result?.standardResult?.instances ?? [];
         // For each of its standard instances:
         instances.forEach(instance => {
-          const {catalogIndex, issueID} = instance;
-          // If the instance identifies its rule as belonging to a non-ignorable issue:
-          if (issueID && issueID !== 'ignorable') {
+          const {catalogIndex, issueID, outcome} = instance;
+          // If the instance reports a violation and identifies a non-ignorable issue:
+          if (outcome !== 'cantTell' && issueID && issueID !== 'ignorable') {
             const issueClassification = issueSpecs[issueID];
             // If the issue has a current weighted classification:
             if (issueClassification && [1, 2, 3, 4].includes(issueClassification.weight)) {

package/web/listIssues/listIssues.test.js

@@ -0,0 +1,80 @@
+/*
+  listIssues.test.js
+  UI tests for web/listIssues/index.js using the fixture corpus.
+*/
+
+// IMPORTS
+
+const {test, before, after} = require('node:test');
+const assert = require('node:assert/strict');
+const path = require('node:path');
+const {parse} = require('node-html-parser');
+const {answer} = require('./index');
+
+// SETUP AND TEARDOWN
+
+const savedDBDir = process.env.DB_DIR;
+
+before(() => {
+  process.env.DB_DIR = path.join(__dirname, '..', '..', 'test', 'fixtures', 'db');
+});
+
+after(() => {
+  if (savedDBDir !== undefined) {
+    process.env.DB_DIR = savedDBDir;
+  }
+  else {
+    delete process.env.DB_DIR;
+  }
+});
+
+// TESTS
+
+test('listIssues returns an ok status with valid HTML for the mixed report', async () => {
+  const result = await answer('260101T0000/mix');
+  assert.equal(result.status, 'ok');
+  assert.ok(result.answerPage);
+  const html = parse(result.answerPage);
+  assert.ok(html.querySelector('title'));
+});
+
+test('listIssues includes the page description in the HTML for the mixed report', async () => {
+  const result = await answer('260101T0000/mix');
+  assert.ok(result.answerPage.includes('Mixed Outcomes Page'));
+});
+
+test('listIssues includes links to listViolators for issues in the mixed report', async () => {
+  const result = await answer('260101T0000/mix');
+  const html = parse(result.answerPage);
+  const violatorLinks = html.querySelectorAll('a[href*="listViolators.html"]');
+  assert.ok(violatorLinks.length >= 2);
+  const hrefs = violatorLinks.map(a => a.getAttribute('href'));
+  assert.ok(hrefs.some(href => href.includes('linkNoText')));
+  assert.ok(hrefs.some(href => href.includes('allCaps')));
+});
+
+test('listIssues returns an error status for a hidden report', async () => {
+  const result = await answer('260101T0007/hid');
+  assert.equal(result.status, 'error');
+});
+
+test('listIssues returns an error status for a nonexistent report', async () => {
+  const result = await answer('999999T9999/xyz');
+  assert.equal(result.status, 'error');
+});
+
+test('listIssues for the all-cantTell report shows no issue links', async () => {
+  const result = await answer('260101T0001/ct');
+  assert.equal(result.status, 'ok');
+  const html = parse(result.answerPage);
+  const violatorLinks = html.querySelectorAll('a[href*="listViolators.html"]');
+  assert.equal(violatorLinks.length, 0);
+});
+
+test('listIssues for the empty report shows no issue links', async () => {
+  const result = await answer('260101T0005/emp');
+  assert.equal(result.status, 'ok');
+  const html = parse(result.answerPage);
+  const violatorLinks = html.querySelectorAll('a[href*="listViolators.html"]');
+  assert.equal(violatorLinks.length, 0);
+});

package/web/listReports/listReports.test.js

@@ -0,0 +1,84 @@
+/*
+  listReports.test.js
+  UI tests for web/listReports/index.js using the fixture corpus.
+*/
+
+// IMPORTS
+
+const {test, before, after} = require('node:test');
+const assert = require('node:assert/strict');
+const path = require('node:path');
+const {parse} = require('node-html-parser');
+const {answer} = require('./index');
+
+// SETUP AND TEARDOWN
+
+const savedDBDir = process.env.DB_DIR;
+
+before(() => {
+  process.env.DB_DIR = path.join(__dirname, '..', '..', 'test', 'fixtures', 'db');
+});
+
+after(() => {
+  if (savedDBDir !== undefined) {
+    process.env.DB_DIR = savedDBDir;
+  }
+  else {
+    delete process.env.DB_DIR;
+  }
+});
+
+// TESTS
+
+test('listReports returns an ok status with valid HTML', async () => {
+  const result = await answer();
+  assert.equal(result.status, 'ok');
+  assert.ok(result.answerPage);
+  const html = parse(result.answerPage);
+  assert.equal(html.querySelector('title').text, 'Pages tested | Kilotest');
+});
+
+test('listReports includes the 6 non-hidden fixture reports as details elements', async () => {
+  const result = await answer();
+  const html = parse(result.answerPage);
+  const details = html.querySelectorAll('details');
+  assert.equal(details.length, 6);
+});
+
+test('listReports includes the page descriptions in summary elements', async () => {
+  const result = await answer();
+  const html = parse(result.answerPage);
+  const summaries = html.querySelectorAll('details > summary').map(s => s.text);
+  assert.ok(summaries.some(s => s.startsWith('Mixed Outcomes Page')));
+  assert.ok(summaries.some(s => s.startsWith('All CantTell Page')));
+  assert.ok(summaries.some(s => s.startsWith('No Outcomes Page')));
+  assert.ok(summaries.some(s => s.startsWith('Empty Results Page')));
+  assert.ok(summaries.some(s => s.startsWith('Prevented Page')));
+});
+
+test('listReports does not include the hidden report', async () => {
+  const result = await answer();
+  assert.ok(!result.answerPage.includes('Hidden Page'));
+});
+
+test('listReports includes links to listIssues for reports with issues', async () => {
+  const result = await answer();
+  const html = parse(result.answerPage);
+  const issueLinks = html.querySelectorAll('a[href*="listIssues.html"]');
+  assert.ok(issueLinks.length > 0);
+  const hrefs = issueLinks.map(a => a.getAttribute('href'));
+  assert.ok(hrefs.some(href => href.includes('260101T0000/mix')));
+});
+
+test('listReports includes the page URLs in the report details', async () => {
+  const result = await answer();
+  assert.ok(result.answerPage.includes('https://example.com/mixed'));
+  assert.ok(result.answerPage.includes('https://example.com/canttell'));
+});
+
+test('listReports includes a link to request testing a new page', async () => {
+  const result = await answer();
+  const html = parse(result.answerPage);
+  const testLink = html.querySelector('a[href="requestTestForm.html"]');
+  assert.ok(testLink);
+});

package/web/listViolators/listViolators.test.js

@@ -0,0 +1,66 @@
+/*
+  listViolators.test.js
+  UI tests for web/listViolators/index.js using the fixture corpus.
+*/
+
+// IMPORTS
+
+const {test, before, after} = require('node:test');
+const assert = require('node:assert/strict');
+const path = require('node:path');
+const {parse} = require('node-html-parser');
+const {answer} = require('./index');
+
+// SETUP AND TEARDOWN
+
+const savedDBDir = process.env.DB_DIR;
+
+before(() => {
+  process.env.DB_DIR = path.join(__dirname, '..', '..', 'test', 'fixtures', 'db');
+});
+
+after(() => {
+  if (savedDBDir !== undefined) {
+    process.env.DB_DIR = savedDBDir;
+  }
+  else {
+    delete process.env.DB_DIR;
+  }
+});
+
+// TESTS
+
+test('listViolators returns an ok status with valid HTML for linkNoText in the mixed report', async () => {
+  const result = await answer('linkNoText/260101T0000/mix');
+  assert.equal(result.status, 'ok');
+  assert.ok(result.answerPage);
+  const html = parse(result.answerPage);
+  assert.ok(html.querySelector('title'));
+});
+
+test('listViolators includes the issue summary in the HTML', async () => {
+  const result = await answer('linkNoText/260101T0000/mix');
+  assert.ok(result.answerPage.includes('link not named'));
+});
+
+test('listViolators includes links to listDiagnoses for violators', async () => {
+  const result = await answer('linkNoText/260101T0000/mix');
+  const html = parse(result.answerPage);
+  const diagnosisLinks = html.querySelectorAll('a[href*="listDiagnoses.html"]');
+  assert.ok(diagnosisLinks.length > 0);
+});
+
+test('listViolators returns an error status for a hidden report', async () => {
+  const result = await answer('linkNoText/260101T0007/hid');
+  assert.equal(result.status, 'error');
+});
+
+test('listViolators returns an error status for a nonexistent report', async () => {
+  const result = await answer('linkNoText/999999T9999/xyz');
+  assert.equal(result.status, 'error');
+});
+
+test('listViolators returns an error status for an unknown issue', async () => {
+  const result = await answer('nonexistentIssue/260101T0000/mix');
+  assert.equal(result.status, 'error');
+});

package/api/testSuite.js

@@ -1,311 +0,0 @@
-/*
-  © 2026 Jonathan Robert Pool.
-
-  Licensed under the MIT License. See LICENSE file at the project root or
-  https://opensource.org/license/mit/ for details.
-
-  SPDX-License-Identifier: MIT
-*/
-
-/*
-  researchAgent.js
-  Simulates a research agent.
-*/
-
-// IMPORTS
-
-require('dotenv').config();
-const httpClient = require('http');
-const httpsClient = require('https');
-
-// CONSTANTS
-
-const kilotestHosts = [
-  process.env.LOCAL_KILOTEST_HOST || 'http://localhost:3000',
-  process.env.DEPLOYED_KILOTEST_HOST || 'https://kilotest.com'
-];
-// Kilotest host specified by the argument.
-const kilotestHost = kilotestHosts[process.argv[2] === 'pub' ? 1 : 0];
-const hostParts = kilotestHost.split(/:\/*/);
-const scheme = hostParts[0] === 'https' ? 'https' : 'http';
-const client = scheme === 'https' ? httpsClient : httpClient;
-const host = hostParts[1] || 'localhost';
-const port = hostParts[2] || (scheme === 'https' ? 443 : 80);
-
-// FUNCTIONS
-
-// Gets, parses into an object, and returns the body of a response.
-const getBody = async response => {
-  const body = await new Promise(resolve => {
-    // Initialize an array of data from the response.
-    const chunks = [];
-    response
-    // If the response throws an error:
-    .on('error', error => {
-      const {message} = error;
-      // Report and return the error message.
-      console.log(message);
-      resolve({error: message});
-    })
-    // Whenever the response delivers data:
-    .on('data', chunk => {
-      // Add them to the array.
-      chunks.push(chunk);
-    })
-    // When the response is completed:
-    .on('end', () => {
-      const bodyString = chunks.join('');
-      try {
-        const body = JSON.parse(bodyString);
-        // Return the response body as an object.
-        resolve(body);
-      }
-      // If it is not JSON:
-      catch {
-        // Return this.
-        resolve({error: `Response body not JSON (${bodyString})`});
-      }
-    });
-  });
-  return body;
-};
-const getRequestOptions = (path, method = 'GET') => ({
-  method,
-  host,
-  port,
-  path,
-  headers: {
-    'body-type': 'application/json; charset=utf-8'
-  }
-});
-// Submits a request, returns the response body, and increments the results.
-const submitRequest = async (path, method, requestBody = null) => new Promise(resolve => {
-  console.log(`Making ${scheme} ${method} request on port ${port} of ${host} to ${path}`);
-  client.request(getRequestOptions(path, method), async response => {
-    const responseBody = await getBody(response);
-    resolve(responseBody);
-  })
-  .on('error', error => {
-    console.log(`ERROR submitting request (${JSON.stringify(error, null, 2)})`);
-    resolve({error});
-  })
-  .end(requestBody ? JSON.stringify(requestBody) : '');
-});
-// Submits requests to the specified Kilotest host.
-const requestService = async () => {
-  let body;
-  let jobID;
-  let method;
-  let path;
-  let reportBasics;
-  let reportsBasics;
-  let requestDetails;
-  let requestDisposition;
-  let responseContent;
-  let timeStamp;
-  console.log('======================\nRequest: List all available reports');
-  method = 'GET';
-  path = '/api/listReports';
-  body = await submitRequest(path, method);
-  responseContent = body?.['response content'] ?? {};
-  reportsBasics = responseContent?.['basics about all available reports'] ?? [];
-  if (
-    !reportsBasics.length
-    || !Array.isArray(reportsBasics)
-    || !reportsBasics.length
-    || reportsBasics.some(
-      reportBasics => reportBasics['how to get details about the report']?.method !== 'GET'
-    )
-  ) {
-    console.log(`reportsBasics: ${JSON.stringify(reportsBasics, null, 2)}`);
-    return;
-  }
-  console.log('======================\nRequest: List issues in one nonexistent report');
-  [timeStamp, jobID] = ['111111T1111', 'abc'];
-  method = 'GET';
-  path = `/api/listIssues/${timeStamp}/${jobID}`;
-  body = await submitRequest(path, method);
-  responseContent = body?.['response content'] ?? {};
-  reportBasics = responseContent?.['basics about the report'] ?? {};
-  if (
-    !reportBasics.error || !reportBasics.error.includes('missing, unreadable, or not JSON')
-  ) {
-    console.log(`reportBasics: ${JSON.stringify(reportBasics, null, 2)}`);
-    return;
-  }
-  console.log('======================\nRequest: List issues in one report');
-  const reportsBasicsIndex = Math.floor(reportsBasics.length * Math.random());
-  // Choose one report at random.
-  reportBasics = reportsBasics[reportsBasicsIndex];
-  // Get whether the report has been superseded by a later report about the same page.
-  const isSuperseded = reportBasics['whether a later report about the same page exists'];
-  [timeStamp, jobID] = reportBasics.identifier?.split('-') || [null, null];
-  if (!(timeStamp && jobID)) {
-    console.log(`reportBasicsIndex: ${reportsBasicsIndex}`);
-    console.log(`reportBasics: ${JSON.stringify(reportBasics, null, 2)}`);
-    return;
-  }
-  path = `/api/listIssues/${timeStamp}/${jobID}`;
-  body = await submitRequest(path, method);
-  responseContent = body?.['response content'] ?? {};
-  const issuesBasics = responseContent?.['basics about all issues reported in the report'] ?? [];
-  if (
-    !issuesBasics.length
-    || !Array.isArray(issuesBasics)
-    || !issuesBasics.length
-    || issuesBasics.some(issueBasics => !issueBasics['impact on a user'])
-  ) {
-    console.log(`issuesBasics: ${JSON.stringify(issuesBasics, null, 2)}`);
-    return;
-  }
-  console.log('======================\nRequest: List violators of one issue in one report');
-  // Get the issue IDs.
-  const issueIDs = issuesBasics.map(issueBasics => issueBasics.identifier);
-  // Choose one at random.
-  const issueID = issueIDs[Math.floor(Math.random() * issueIDs.length)];
-  path = `/api/listViolators/${issueID}/${timeStamp}/${jobID}`;
-  body = await submitRequest(path, method);
-  responseContent = body?.['response content'] ?? {};
-  const violatorsBasics = responseContent?.['basics about all elements exhibiting the issue'] ?? [];
-  if (
-    !violatorsBasics.length
-    || !Array.isArray(violatorsBasics)
-    || !violatorsBasics.length
-    || violatorsBasics.some(violatorBasics => !violatorBasics[
-      'count of rule engines reporting that the element exhibited the issue'
-    ])
-  ) {
-    console.log(`violatorsBasics: ${JSON.stringify(violatorsBasics, null, 2)}`);
-    return;
-  }
-  console.log(
-    '======================\nRequest: List diagnoses of one violation of one issue in one report'
-  );
-  // Get the issue IDs.
-  const violatorIDs = violatorsBasics.map(violatorBasics => violatorBasics.identifier);
-  // Choose one at random.
-  const violatorID = violatorIDs[Math.floor(Math.random() * violatorIDs.length)];
-  path = `/api/listDiagnoses/${violatorID}/${issueID}/${timeStamp}/${jobID}`;
-  body = await submitRequest(path, method);
-  responseContent = body?.['response content'] ?? {};
-  const diagnoses = responseContent?.['diagnoses of how the element exhibited the issue'] ?? [];
-  if (
-    !diagnoses.length
-    || !Array.isArray(diagnoses)
-    || !diagnoses.length
-    || diagnoses.some(
-      diagnosis => typeof diagnosis !== 'object' || !diagnosis['description of the violation']
-    )
-  ) {
-    console.log(`diagnoses: ${JSON.stringify(diagnoses, null, 2)}`);
-    return;
-  }
-  console.log('======================\nRequest: Get one report');
-  path = `/api/getReport/${timeStamp}/${jobID}`;
-  body = await submitRequest(path, method);
-  responseContent = body?.['response content'] ?? {};
-  const fullReport = responseContent?.['full report'] ?? {};
-  if (responseContent.error || typeof fullReport !== 'object' || !fullReport.device) {
-    console.log('Full report request failed');
-    return;
-  }
-  console.log('======================\nRequest: Make a test request with the GET method');
-  path = '/api/requestTest';
-  body = await submitRequest(path, method);
-  if (body.error?.message !== 'Invalid service request') {
-    console.log(`body: ${JSON.stringify(body, null, 2)}`);
-    return;
-  }
-  console.log('======================\nRequest: Request a test with a too short URL');
-  method = 'POST';
-  body = await submitRequest(path, method, {
-    description: 'Zilch',
-    URL: 'https://a.b',
-    reason: 'Just because'
-  });
-  responseContent = body?.['response content'] ?? {};
-  requestDetails = responseContent['details about your request'] ?? {};
-  if (!requestDetails.error?.includes('specified a URL for the page')) {
-    console.log(`requestDetails: ${JSON.stringify(requestDetails, null, 2)}`);
-    return;
-  }
-  console.log('======================\nRequest: Request a test');
-  body = await submitRequest(path, method, {
-    description: 'Organization that does not exist',
-    URL: 'https://nonexistentorg.com',
-    reason: 'I have no good reason for wanting this page to be tested'
-  });
-  responseContent = body?.['response content'] ?? {};
-  requestDetails = responseContent['details about your request'] ?? {};
-  requestDisposition = responseContent['disposition of your request'] ?? {};
-  if (
-    !requestDetails['reason why the page should be tested']
-    || !requestDisposition['what happens next']?.includes('1 hour to 1 day')
-  ) {
-    console.log(`requestDetails: ${JSON.stringify(requestDetails, null, 2)}`);
-    console.log(`requestDisposition: ${JSON.stringify(requestDisposition, null, 2)}`);
-    return;
-  }
-  console.log('======================\nRequest: Request a retest of a nonexistent report');
-  path = `/api/requestRetest/${timeStamp}/xyz`;
-  body = await submitRequest(path, method, {
-    reason: 'It would be cool to retest what does not exist'
-  });
-  responseContent = body?.['response content'] ?? {};
-  requestDetails = responseContent['details about your request'] ?? {};
-  if (!requestDetails.error?.includes('not an available report')) {
-    console.log(`requestDetails: ${JSON.stringify(requestDetails, null, 2)}`);
-    return;
-  }
-  console.log('======================\nRequest: Request a retest');
-  path = `/api/requestRetest/${timeStamp}/${jobID}`;
-  body = await submitRequest(path, method, {
-    reason: 'I just feel like making this request'
-  });
-  responseContent = body?.['response content'] ?? {};
-  requestDetails = responseContent['details about your request'] ?? {};
-  requestDisposition = responseContent['disposition of your request'] ?? {};
-  // If the report has been superseded:
-  if (isSuperseded) {
-    // Expect the request to be rejected.
-    if (!requestDetails.error?.includes('a later report about the page exists')) {
-      console.log(`requestDetails: ${JSON.stringify(requestDetails, null, 2)}`);
-      return;
-    }
-  }
-  // Otherwise, i.e. if the report has not been superseded:
-  else {
-    if (
-      !requestDetails['reason why the page should be retested']
-      || !requestDisposition['how you can check for completion']
-    ) {
-      console.log(`requestDetails: ${JSON.stringify(requestDetails, null, 2)}`);
-      console.log(`requestDisposition: ${JSON.stringify(requestDisposition, null, 2)}`);
-      return;
-    }
-  }
-  console.log('======================\nRequest: Make a feature request');
-  path = '/api/requestFeature';
-  const featureRequest = 'Do the impossible';
-  body = await submitRequest(path, method, {
-    feature: featureRequest
-  });
-  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;
-  }
-  console.log('======================\nRequest: Results');
-  console.log('All tests succeeded');
-};
-
-// EXECUTION
-
-// Execute the research agent.
-(async () => {
-  await requestService();
-})();