@jrpool/kilotest 43.0.1 → 44.0.0

package/api/getReport.js

@@ -56,7 +56,7 @@ exports.response = async args => {
     },
     'URLs of similar requests for web users': {
       'this request': `${thisHost}/fullReport.json/${timeStamp}/${jobID}`,
-      'closest ancestor request': `${thisHost}/reportIssues.html/${timeStamp}/${jobID}`
+      'closest ancestor request': `${thisHost}/listIssues.html/${timeStamp}/${jobID}`
     },
     'response metadata': getResponseMetadata(),
     'response content': responseContent

package/api/listDiagnoses.js

@@ -146,8 +146,8 @@ exports.response = async args => {
       }
     },
     'URLs of similar requests for web users': {
-      'this request': `${thisHost}/diagnoses.html/${issueID}/${timeStamp}/${jobID}/${catalogIndex}`,
-      'closest ancestor request': `${thisHost}/reportIssue.html/${issueID}/${timeStamp}/${jobID}`
+      'this request': `${thisHost}/listDiagnoses.html/${issueID}/${timeStamp}/${jobID}/${catalogIndex}`,
+      'closest ancestor request': `${thisHost}/listViolators.html/${issueID}/${timeStamp}/${jobID}`
     },
     'response metadata': getResponseMetadata(),
     'response content': responseContent

package/api/listIssues.js

@@ -172,7 +172,7 @@ exports.response = async args => {
         };
         // Add instructions for a web user to request a retest.
         responseContent['how a web user can request that the page be retested'] = {
-          URL: `${thisHost}/retestRecForm.html/${timeStamp}/${jobID}`
+          URL: `${thisHost}/requestRetestForm.html/${timeStamp}/${jobID}`
         };
       }
       // Sort the data about issues by summary.
@@ -191,7 +191,7 @@ exports.response = async args => {
             method: 'GET',
             URL: `${thisHost}/api/listViolators/${id}/${timeStamp}/${jobID}`
           },
-          'web users can get details about the issue at': `${thisHost}/reportIssue.html/${id}/${timeStamp}/${jobID}`
+          'web users can get details about the issue at': `${thisHost}/listViolators.html/${id}/${timeStamp}/${jobID}`
         };
       });
       // Add the basics about the issues to the response content.
@@ -214,8 +214,8 @@ exports.response = async args => {
       }
     },
     'URLs of similar requests for web users': {
-      'this request': `${thisHost}/reportIssues.html/${timeStamp}/${jobID}`,
-      'closest ancestor request': `${thisHost}/targets.html`
+      'this request': `${thisHost}/listIssues.html/${timeStamp}/${jobID}`,
+      'closest ancestor request': `${thisHost}/listReports.html`
     },
     'response metadata': getResponseMetadata(),
     'response content': responseContent

package/api/listReports.js

@@ -34,7 +34,7 @@ exports.response = async () => {
         method: 'GET',
         URL: `${thisHost}/api/listIssues/${timeStamp}/${jobID}`
       };
-      reportBasics['web users can get details about the report at'] = `${thisHost}/reportIssues.html/${timeStamp}/${jobID}`;
+      reportBasics['web users can get details about the report at'] = `${thisHost}/listIssues.html/${timeStamp}/${jobID}`;
       // Add the basics to the array.
       reportsBasics.push(reportBasics);
     }
@@ -63,7 +63,7 @@ exports.response = async () => {
   };
   // Add instructions for a web user to request a test to the response content.
   responseContent['how a web user can request that the page be tested'] = {
-    URL: `${thisHost}/testRecForm.html`
+    URL: `${thisHost}/requestTestForm.html`
   };
   // Create a response body.
   const body = {
@@ -76,7 +76,7 @@ exports.response = async () => {
       'closest ancestor request': null
     },
     'URLs of similar requests for web users': {
-      'this request': `${thisHost}/targets.html`,
+      'this request': `${thisHost}/listReports.html`,
       'closest ancestor request': null
     },
     'response metadata': getResponseMetadata(),

package/api/listViolators.js

@@ -130,7 +130,7 @@ exports.response = async args => {
             URL: `${thisHost}/api/listDiagnoses/${catalogIndex}/${issueID}/${timeStamp}/${jobID}`,
             'request method': 'GET'
           },
-          'web users can get details about the element at': `${thisHost}/diagnoses.html/${issueID}/${timeStamp}/${jobID}/${catalogIndex}`
+          'web users can get details about the element at': `${thisHost}/listDiagnoses.html/${issueID}/${timeStamp}/${jobID}/${catalogIndex}`
         };
       });
       // Add basics about the violators to the response content.
@@ -153,8 +153,8 @@ exports.response = async args => {
       }
     },
     'URLs of similar requests for web users': {
-      'this request': `${thisHost}/reportIssue.html/${issueID}/${timeStamp}/${jobID}`,
-      'closest ancestor request': `${thisHost}/reportIssues.html/${timeStamp}/${jobID}`
+      'this request': `${thisHost}/listViolators.html/${issueID}/${timeStamp}/${jobID}`,
+      'closest ancestor request': `${thisHost}/listIssues.html/${timeStamp}/${jobID}`
     },
     'response metadata': getResponseMetadata(),
     'response content': responseContent

package/api/requestRetest.js

@@ -69,7 +69,7 @@ exports.response = async args => {
     responseContent['disposition of your request'] = {
       'what happens next': 'Your request is likely to be approved and processed within 1 hour to 1 day.',
       'how you can check for completion': 'You can call the listReports tool to learn whether the page has been retested and a new report is available.',
-      'how a web user can check for completion': `A web user can visit ${thisHost}/targets.html to learn whether the page has been retested and a new report is available.`
+      'how a web user can check for completion': `A web user can visit ${thisHost}/listReports.html to learn whether the page has been retested and a new report is available.`
     };
   }
   // Create a response body.
@@ -91,8 +91,8 @@ exports.response = async args => {
       }
     },
     'URLs of similar requests for web users': {
-      'this request': `${thisHost}/retestRecForm.html/${timeStamp}/${jobID}`,
-      'closest ancestor request': `${thisHost}/reportIssues.html/${timeStamp}/${jobID}`
+      'this request': `${thisHost}/requestRetestForm.html/${timeStamp}/${jobID}`,
+      'closest ancestor request': `${thisHost}/listIssues.html/${timeStamp}/${jobID}`
     },
     'response metadata': getResponseMetadata(),
     'response content': responseContent

package/api/requestTest.js

@@ -70,7 +70,7 @@ exports.response = async args => {
       responseContent['disposition of your request'] = {
         'what happens next': 'Your request is likely to be approved and processed within 1 hour to 1 day.',
         'how you can check for completion': 'You can call the listReports tool to learn whether the page has been tested and a report is available.',
-        'how a web user can check for completion': `A web user can visit ${thisHost}/targets.html to learn whether the page has been tested and a report is available.`
+        'how a web user can check for completion': `A web user can visit ${thisHost}/listReports.html to learn whether the page has been tested and a report is available.`
       };
     }
   }
@@ -95,8 +95,8 @@ exports.response = async args => {
       }
     },
     'URLs of similar requests for web users': {
-      'this request': `${thisHost}/testRecForm.html`,
-      'closest ancestor request': `${thisHost}/targets.html`
+      'this request': `${thisHost}/requestTestForm.html`,
+      'closest ancestor request': `${thisHost}/listReports.html`
     },
     'response metadata': getResponseMetadata(),
     'response content': responseContent

package/docs/SERVICE.md

@@ -203,7 +203,7 @@ kilotest.com {
   }
   @allowedPOST {
     method POST
-    path /mcp /retestRec.html/* /testRec.html /recAction.html /reannotate.html /wcagRenew.html /api/* /tutorialComment.html
+    path /mcp /requestRetest.html/* /requestTest.html /recAction.html /reannotate.html /renewWCAG.html /api/* /tutorialComment.html
   }
   # Respond to OPTIONS requests.
   @allowedOPTIONS method OPTIONS

package/index.html

@@ -86,8 +86,8 @@
       </details>
       <h2>What do you want to know?</h2>
       <ul class="nav">
-        <li><a href="targets.html">Which web pages have been tested?</a></li>
-        <li><a href="issues.html">Which issues have been reported?</a></li>
+        <li><a href="listReports.html">Which web pages have been tested?</a></li>
+        <li><a href="listTopIssues.html">Which issues have been reported?</a></li>
         <li><a href="manage.html">What can Kilotest managers do?</a></li>
       </ul>
     </main>

package/index.js

@@ -30,36 +30,36 @@ const {
 } = require('./util');
 const {handleMCP, mcpPath} = require('./mcp');
 const fs = require('fs/promises');
-const {handleComment} = require('./tutorial/index');
+const {handleComment} = require('./web/tutorial/index');
 const http = require('http');
 const https = require('https');
 const path = require('path');
 const {sendAlert} = require('./alerts');
 const answer = {
-  ai0BalanceForm: require('./ai0BalanceForm/index').answer,
-  diagnoses: require('./diagnoses/index').answer,
-  issues: require('./issues/index').answer,
-  manage: require('./manage/index').answer,
-  reannotate: require('./reannotate/index').answer,
-  reannotateForm: require('./reannotateForm/index').answer,
-  recActionForm: require('./recActionForm/index').answer,
-  reportIssue: require('./reportIssue/index').answer,
-  reportIssues: require('./reportIssues/index').answer,
-  reportsExpungeForm: require('./reportsExpungeForm/index').answer,
-  reportHideForm: require('./reportHideForm/index').answer,
-  reportsPruneForm: require('./reportsPruneForm/index').answer,
-  reportsRewindForm: require('./reportsRewindForm/index').answer,
-  reportUnhideForm: require('./reportUnhideForm/index').answer,
-  retestRec: require('./retestRec/index').answer,
-  retestRecForm: require('./retestRecForm/index').answer,
-  rules: require('./rules/index').answer,
-  targets: require('./targets/index').answer,
-  testOrder: require('./testOrder/index').answer,
-  testRec: require('./testRec/index').answer,
-  testRecForm: require('./testRecForm/index').answer,
-  tutorial: require('./tutorial/index').answer,
-  wcagRenew: require('./wcagRenew/index').answer,
-  wcagRenewForm: require('./wcagRenewForm/index').answer
+  ai0BalanceForm: require('./web/ai0BalanceForm/index').answer,
+  enqueue: require('./web/enqueue/index').answer,
+  enqueueForm: require('./web/enqueueForm/index').answer,
+  expungeReportsForm: require('./web/expungeReportsForm/index').answer,
+  hideReportForm: require('./web/hideReportForm/index').answer,
+  listDiagnoses: require('./web/listDiagnoses/index').answer,
+  listIssues: require('./web/listIssues/index').answer,
+  listReports: require('./web/listReports/index').answer,
+  listRules: require('./web/listRules/index').answer,
+  listTopIssues: require('./web/listTopIssues/index').answer,
+  listViolators: require('./web/listViolators/index').answer,
+  manage: require('./web/manage/index').answer,
+  pruneReportsForm: require('./web/pruneReportsForm/index').answer,
+  reannotate: require('./web/reannotate/index').answer,
+  reannotateForm: require('./web/reannotateForm/index').answer,
+  renewWCAG: require('./web/renewWCAG/index').answer,
+  renewWCAGForm: require('./web/renewWCAGForm/index').answer,
+  requestRetest: require('./web/requestRetest/index').answer,
+  requestRetestForm: require('./web/requestRetestForm/index').answer,
+  requestTest: require('./web/requestTest/index').answer,
+  requestTestForm: require('./web/requestTestForm/index').answer,
+  rewindReportsForm: require('./web/rewindReportsForm/index').answer,
+  unhideReportForm: require('./web/unhideReportForm/index').answer,
+  tutorial: require('./web/tutorial/index').answer
 };
 
 // CONSTANTS
@@ -505,7 +505,7 @@ const requestHandler = async (request, response) => {
     // Otherwise, if it is for a tutorial image:
     else if (pathname.startsWith('/tutorial/images/')) {
       const imgFile = pathname.slice('/tutorial/images/'.length);
-      const imgPath = path.join(__dirname, 'tutorial', 'images', imgFile);
+      const imgPath = path.join(__dirname, 'web', 'tutorial', 'images', imgFile);
       try {
         const img = await fs.readFile(imgPath);
         const ext = path.extname(imgFile).toLowerCase();
@@ -564,7 +564,7 @@ const requestHandler = async (request, response) => {
       // Get the data from the request body.
       const postData = await getPOSTData(request);
       // If the request is a test recommendation:
-      if (pageName === 'testRec.html') {
+      if (pageName === 'requestTest.html') {
         const {what, url, why} = postData;
         // If the request is valid:
         if (what && url.startsWith('https://') && why) {
@@ -578,7 +578,7 @@ const requestHandler = async (request, response) => {
             // Serve headers for a response.
             setHeaders('text/html', pathname, 'ultra');
             // Get the answer data.
-            const answerData = await require(path.join(__dirname, 'testRec', 'index'))
+            const answerData = await require(path.join(__dirname, 'web', 'requestTest', 'index'))
             .answer(what, url, why);
             // If they are valid:
             if (answerData.status === 'ok') {
@@ -599,7 +599,7 @@ const requestHandler = async (request, response) => {
         }
       }
       // Otherwise, if it is a retest recommendation:
-      else if (pageName === 'retestRec.html') {
+      else if (pageName === 'requestRetest.html') {
         const {why} = postData;
         const [timeStamp, jobID] = pathTail.split('/');
         // If the request is valid:
@@ -607,7 +607,7 @@ const requestHandler = async (request, response) => {
           // Serve response headers.
           setHeaders('text/html', pathname, 'ultra');
           // Get the answer data.
-          const answerData = await require(path.join(__dirname, 'retestRec', 'index'))
+          const answerData = await require(path.join(__dirname, 'web', 'requestRetest', 'index'))
           .answer(pathTail, why);
           // If they are valid:
           if (answerData.status === 'ok') {
@@ -626,7 +626,7 @@ const requestHandler = async (request, response) => {
           await serveError({message: 'ERROR: Invalid retest recommendation'}, response, true);
         }
       }
-      // Otherwise, if it is an action on a test or retest recommendation:
+      // Otherwise, if it is an approval or rejection of a test request:
       else if (pageName === 'recAction.html') {
         const {target, authCode} = postData;
         const [url, what] = target.split('\t');
@@ -639,7 +639,7 @@ const requestHandler = async (request, response) => {
             // Set a location header for a response.
             response.setHeader('content-location', pathname);
             // Process the approval and get the answer data about the remaining recommendations.
-            const answerData = await require(path.join(__dirname, 'testOrder', 'index'))
+            const answerData = await require(path.join(__dirname, 'web', 'enqueue', 'index'))
             .answer(url, what, authCode);
             // If the answer data are valid:
             if (answerData.status === 'ok') {
@@ -664,9 +664,10 @@ const requestHandler = async (request, response) => {
               await fs.writeFile(path.join(jobsPath, 'recs.json'), getJSON(recs));
             });
             // Set a location header for a response.
-            response.setHeader('content-location', '/recActionForm.html');
+            response.setHeader('content-location', '/enqueueForm.html');
             // Get the answer data.
-            const answerData = await require(path.join(__dirname, 'recActionForm', 'index')).answer();
+            const answerData = await require(path.join(__dirname, 'web', 'enqueueForm', 'index'))
+            .answer();
             // Serve the test-order form with the remaining recommendations.
             response.end(answerData.answerPage);
           }
@@ -683,7 +684,7 @@ const requestHandler = async (request, response) => {
         // Set headers for a response.
         setHeaders('text/html', pathname, 'ultra');
         // Get the answer data.
-        const answerData = await require(path.join(__dirname, 'reannotate', 'index'))
+        const answerData = await require(path.join(__dirname, 'web', 'reannotate', 'index'))
         .answer(authCode);
         // If the answer data are valid:
         if (answerData.status === 'ok') {
@@ -697,12 +698,12 @@ const requestHandler = async (request, response) => {
         }
       }
       // Otherwise, if it is a WCAG map renewal:
-      else if (pageName === 'wcagRenew.html') {
+      else if (pageName === 'renewWCAG.html') {
         const {authCode} = postData;
         // Set headers for a response.
         setHeaders('text/html', pathname, 'low');
         // Get the answer data.
-        const answerData = await require(path.join(__dirname, 'wcagRenew', 'index'))
+        const answerData = await require(path.join(__dirname, 'web', 'renewWCAG', 'index'))
         .answer(authCode);
         // If the answer data are valid:
         if (answerData.status === 'ok') {

package/llms-full.txt

@@ -59,13 +59,13 @@ In the marketplace for MCP servers that test for front-end quality, all servers
 Kilotest offers a comprehensive suite of capabilities to users via its web UI:
 
 - [Home page](https://kilotest.com/)
-- [Get summary test results for all tested pages](https://kilotest.com/targets.html)
-- Get statistics about issues reported in one report: `https://kilotest.com/reportIssues.html/{timeStamp}/{jobID}`
-- Get details about one issue reported in one report: `https://kilotest.com/reportIssue.html/{issueID}/{timeStamp}/{jobID}`
-- Get diagnoses by rule engines of rule violations for one HTML element exhibiting one issue in one report: `https://kilotest.com/diagnoses.html/{issueID}/{timeStamp}/{jobID}/{catalogIndex}`
-- [Recommend the testing of a not-yet-tested page](https://kilotest.com/testRecForm.html)
-- Recommend the retesting of a previously tested page: `https://kilotest.com/retestRecForm.html/{timeStamp}/{jobID}`
-- [Get statistics about frequently reported issues across all pages](https://kilotest.com/issues.html)
+- [Get summary test results for all tested pages](https://kilotest.com/listReports.html)
+- Get statistics about issues reported in one report: `https://kilotest.com/listIssues.html/{timeStamp}/{jobID}`
+- Get details about one issue reported in one report: `https://kilotest.com/listViolators.html/{issueID}/{timeStamp}/{jobID}`
+- Get diagnoses by rule engines of rule violations for one HTML element exhibiting one issue in one report: `https://kilotest.com/listDiagnoses.html/{issueID}/{timeStamp}/{jobID}/{catalogIndex}`
+- [Recommend the testing of a not-yet-tested page](https://kilotest.com/requestTestForm.html)
+- Recommend the retesting of a previously tested page: `https://kilotest.com/requestRetestForm.html/{timeStamp}/{jobID}`
+- [Get statistics about frequently reported issues across all pages](https://kilotest.com/listTopIssues.html)
 - [Get a list of the operations that Kilotest managers are authorized to request](https://kilotest.com/manage.html)
 - [Tutorial, “Accessibility testing strategies”](https://kilotest.com/tutorial.html)
 - [Tutorial, “QAI tutorial”](https://kilotest.com/qai/)
@@ -145,7 +145,7 @@ When you request a test or a retest:
   - rejection
 - how to confirm approval
   - check test completion by calling `listReports` and looking for the page and completion date in the list
-  - you advise the user to check in approximately 1 day for the test results on the Kilotest website, starting at `https://kilotest.com/targets.html`
+  - you advise the user to check in approximately 1 day for the test results on the Kilotest website, starting at `https://kilotest.com/listReports.html`
 
 An [OpenAPI specification for Kilotest](https://kilotest.com/openapi.yaml) is available.
 

package/llms.txt

@@ -19,15 +19,15 @@ Kilotest helps language models and AI platforms to give thorough, accurate and t
 
 ## Web UI
 
-- [List all available reports](https://kilotest.com/targets.html)
-- List all issues in one report: `https://kilotest.com/reportIssues.html/{timeStamp}/{jobID}`
-- List all elements exhibiting one issue in one report: `https://kilotest.com/reportIssue.html/{issueID}/{timeStamp}/{jobID}`
-- List all diagnoses of one element exhibiting one issue in one report: `https://kilotest.com/diagnoses.html/{issueID}/{timeStamp}/{jobID}/{catalogIndex}`
+- [List all available reports](https://kilotest.com/listReports.html)
+- List all issues in one report: `https://kilotest.com/listIssues.html/{timeStamp}/{jobID}`
+- List all elements exhibiting one issue in one report: `https://kilotest.com/listViolators.html/{issueID}/{timeStamp}/{jobID}`
+- List all diagnoses of one element exhibiting one issue in one report: `https://kilotest.com/listDiagnoses.html/{issueID}/{timeStamp}/{jobID}/{catalogIndex}`
 - Get one full report in JSON: `https://kilotest.com/fullReport.json/{timeStamp}/{jobID}`
-- [Request testing of a web page](https://kilotest.com/testRecForm.html)
-- Request retesting of a web page: `https://kilotest.com/retestRecForm.html/{timeStamp}/{jobID}`
+- [Request testing of a web page](https://kilotest.com/requestTestForm.html)
+- Request retesting of a web page: `https://kilotest.com/requestRetestForm.html/{timeStamp}/{jobID}`
 - [List the operations that Kilotest managers are authorized to request](https://kilotest.com/manage.html)
-- [Provide statistics about frequently reported issues across all pages](https://kilotest.com/issues.html)
+- [Provide statistics about frequently reported issues across all pages](https://kilotest.com/listTopIssues.html)
 - [Tutorial, “Accessibility testing strategies”](https://kilotest.com/tutorial.html)
 
 ## More documents

package/package.json

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

package/robots.txt

@@ -2,15 +2,15 @@
 User-agent: *
 Allow: /
 Disallow: /ai0BalanceForm.html
-Disallow: /recActionForm.html
+Disallow: /enqueueForm.html
 Disallow: /recAction.html
 Disallow: /reannotateForm.html
 Disallow: /reannotate.html
-Disallow: /reportHideForm.html
-Disallow: /reportUnhideForm.html
-Disallow: /reportsPruneForm.html
-Disallow: /reportsRewindForm.html
-Disallow: /reportsExpungeForm.html
-Disallow: /wcagRenewForm.html
-Disallow: /wcagRenew.html
+Disallow: /hideReportForm.html
+Disallow: /unhideReportForm.html
+Disallow: /pruneReportsForm.html
+Disallow: /rewindReportsForm.html
+Disallow: /expungeReportsForm.html
+Disallow: /renewWCAGForm.html
+Disallow: /renewWCAG.html
 Sitemap: https://kilotest.com/sitemap.xml

package/sitemap.xml

@@ -1,9 +1,9 @@
 <!-- sitemap.xml -->
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
   <url><loc>https://kilotest.com/</loc></url>
-  <url><loc>https://kilotest.com/targets.html</loc></url>
-  <url><loc>https://kilotest.com/issues.html</loc></url>
-  <url><loc>https://kilotest.com/testRecForm.html</loc></url>
+  <url><loc>https://kilotest.com/listReports.html</loc></url>
+  <url><loc>https://kilotest.com/listTopIssues.html</loc></url>
+  <url><loc>https://kilotest.com/requestTestForm.html</loc></url>
   <url><loc>https://kilotest.com/manage.html</loc></url>
   <url><loc>https://kilotest.com/tutorial.html</loc></url>
   <url><loc>https://kilotest.com/openapi.yaml</loc></url>

package/util.js

@@ -339,12 +339,12 @@ const objectSort = exports.objectSort = (objects, property, sortType) => objects
   // Otherwise, do not sort.
   return 0;
 });
-// Processes a test or retest recommendation in the UI.
-exports.processRec = async (testType, dirName, what, url, why) => {
+// Processes a test or retest request in the UI.
+exports.processTestRequest = async (testType, dirName, what, url, why) => {
   // If the recommendation is valid:
   if (
     ['test', 'retest'].includes(testType)
-    && ['testRec', 'retestRec'].some(end => dirName.endsWith(end))
+    && ['Test', 'Retest'].some(end => dirName.endsWith(end))
     && what
     && isURL(url)
     && why.length > 4

package/{ai0BalanceForm → web/ai0BalanceForm}/index.js

@@ -7,11 +7,11 @@
 
 const fs = require('fs/promises');
 const path = require('path');
-const {getJSON} = require('../util');
+const {getJSON} = require('../../util');
 
 // CONSTANTS
 
-const balancePath = path.join(__dirname, '../ai0Balance.json');
+const balancePath = path.join(__dirname, '../../ai0Balance.json');
 
 // FUNCTIONS
 

package/{testOrder → web/enqueue}/index.js

@@ -1,22 +1,24 @@
 /*
   index.js
-  Implements a retest order.
+  Implements a test request approval.
 */
 
 // IMPORTS
 
-const {getJSON, getNowStamp, getRandomString, getRecs, isURL, jobsPath, recsLock} = require('../util');
+const {
+  getJSON, getNowStamp, getRandomString, getRecs, isURL, jobsPath, recsLock
+} = require('../../util');
 const fs = require('fs/promises');
 const path = require('path');
 
 // FUNCTIONS
 
-// Implements a test order and returns a revised recommendations page.
+// Implements a test request approval and returns a revised request page.
 exports.answer = async (url, what, authCode) => {
   // If the arguments are valid:
   if (isURL(url) && what && authCode === process.env.AUTH_CODE) {
     // Get the job template.
-    const jobTemplateJSON = await fs.readFile(path.join(__dirname, '..', 'job.json'), 'utf8');
+    const jobTemplateJSON = await fs.readFile(path.join(__dirname, '..', '..', 'job.json'), 'utf8');
     const job = JSON.parse(jobTemplateJSON);
     const nowStamp = getNowStamp();
     // Populate the template with job properties.
@@ -40,7 +42,7 @@ exports.answer = async (url, what, authCode) => {
     await recsLock(async () => {
       // Get the recommendations.
       const recs = await getRecs();
-      // Delete the recommendations to retest the target.
+      // Delete the recommendations to test the target.
       delete recs[url];
       // Save the revised recommendations.
       await fs.writeFile(path.join(jobsPath, 'recs.json'), getJSON(recs));

package/{recActionForm → web/enqueueForm}/index.html

@@ -14,7 +14,7 @@
     <main>
       <h1><a href="/">Kilotest</a>: Recommendation approval or rejection</h1>
       <p>To approve a test or retest recommendation, check its recommended page name.</p>
-      <p>To approve testing a page that is not yet recommended, first <a href="targets.html">recommend it</a>.</p>
+      <p>To approve testing a page that is not yet recommended, first <a href="listReports.html">recommend it</a>.</p>
       <p>To reject all recommendations for a page, check the radio button of its URL.</p>
       <form action="/recAction.html" method="post">
         <fieldset>

package/{recActionForm → web/enqueueForm}/index.js

@@ -1,11 +1,11 @@
 /*
   index.js
-  Serves a form for ordering a recommended test.
+  Serves a form for approving or rejecting a test request.
 */
 
 // IMPORTS
 
-const {getRecs} = require('../util');
+const {getRecs} = require('../../util');
 const fs = require('fs/promises');
 const path = require('path');
 

package/{reportsExpungeForm → web/expungeReportsForm}/index.html

@@ -14,7 +14,7 @@
     <main>
       <h1><a href="/">Kilotest</a>: Expunge reports</h1>
       <p>__intro__</p>
-      <form action="/reportsExpungeForm.html">
+      <form action="/expungeReportsForm.html">
         <fieldset>
           <legend>Reports</legend>
           __reports__

package/{reportsExpungeForm → web/expungeReportsForm}/index.js

@@ -5,7 +5,7 @@
 
 // IMPORTS
 
-const {getReportData, makeReportsExtract, objectSort, reportsPath} = require('../util');
+const {getReportData, makeReportsExtract, objectSort, reportsPath} = require('../../util');
 const fs = require('fs/promises');
 const path = require('path');
 

package/{reportHideForm → web/hideReportForm}/index.html

@@ -14,7 +14,7 @@
     <main>
       <h1><a href="/">Kilotest</a>: Classify report as experimental</h1>
       <p>Choose a report to classify as experimental.</p>
-      <form action="/reportHideForm.html">
+      <form action="/hideReportForm.html">
         <fieldset>
           <legend>Reports</legend>
           __reports__

package/{reportHideForm → web/hideReportForm}/index.js

@@ -5,7 +5,7 @@
 
 // IMPORTS
 
-const {getReportExtracts, hiddenReportsPath, makeReportsExtract, reportsPath} = require('../util');
+const {getReportExtracts, hiddenReportsPath, makeReportsExtract, reportsPath} = require('../../util');
 const fs = require('fs/promises');
 const path = require('path');
 

package/{diagnoses → web/listDiagnoses}/index.js

@@ -1,6 +1,6 @@
 /*
   index.js
-  Answers the diagnoses question.
+  Lists the diagnoses of a violator of an issue in a report.
 */
 
 // IMPORTS
@@ -14,7 +14,7 @@ const {
   htmlSafe,
   isHidden,
   tools
-} = require('../util');
+} = require('../../util');
 const {issues: issueSpecs} = require('testaro-issues');
 const fs = require('fs/promises');
 const path = require('path');

package/{reportIssues → web/listIssues}/index.html

@@ -19,7 +19,7 @@
         <li>__testInfo__</li>
         __preventions__
       </ul>
-      <p><a href="/retestRecForm.html/__timeStamp__/__jobID__">Should Kilotest retest the page?</a></p>
+      <p><a href="/requestRetestForm.html/__timeStamp__/__jobID__">Should Kilotest retest the page?</a></p>
       <h2>Issues reported</h2>
       <h3>Summary</h3>
       <p>__reporterCount__ reported issues (__reporters__)</p>

package/{reportIssues → web/listIssues}/index.js

@@ -1,6 +1,6 @@
 /*
   index.js
-  Answers the report-issues question.
+  List the issues in a report.
 */
 
 // IMPORTS
@@ -17,7 +17,7 @@ const {
   isValidReport,
   objectSort,
   tools
-} = require('../util');
+} = require('../../util');
 const {issues: issueSpecs} = require('testaro-issues');
 const fs = require('fs/promises');
 const path = require('path');
@@ -252,7 +252,7 @@ const populateQuery = async (timeStamp, jobID, query) => {
         detailsLines.push(`${margin}    <ul class="nav">`);
         const whereQuestionString = 'Where was the issue found?';
         const labelString = `Where was the ${summary} issue found on the ${what} page?`;
-        const href = `href="/reportIssue.html/${issueID}/${timeStamp}/${jobID}"`;
+        const href = `href="/listViolators.html/${issueID}/${timeStamp}/${jobID}"`;
         const label = `aria-label="${labelString}"`;
         const whereLink = `<a ${href} ${label}>${whereQuestionString}</a>`;
         // Add a violations link to the lines.

package/{targets → web/listReports}/index.html

@@ -18,7 +18,7 @@
         __recs__
       </ol>
       <p>__noRecs__</p>
-      <p>Should Kilotest <a href="testRecForm.html">test a page</a> that is not listed below?</p>
+      <p>Should Kilotest <a href="requestTestForm.html">test a page</a> that is not listed below?</p>
       <h2>Queued for testing</h2>
       <ol>
         __queue__

package/{targets → web/listReports}/index.js

@@ -1,6 +1,6 @@
 /*
   index.js
-  Answers the targets question.
+  Lists all available reports.
 */
 
 // IMPORTS
@@ -18,7 +18,7 @@ const {
   isRecommendable,
   jobsPath,
   objectSort
-} = require('../util');
+} = require('../../util');
 const fs = require('fs/promises');
 const path = require('path');
 
@@ -51,7 +51,7 @@ const populateQuery = async query => {
   query.recs = lines.recs.join('\n');
   // Add a no-recommendations message, if applicable, to the query.
   query.noRecs = lines.recs.length
-  ? 'Kilotest managers can <a href="recActionForm.html">approve or reject a recommendation</a>.'
+  ? 'Kilotest managers can <a href="enqueueForm.html">approve or reject a recommendation</a>.'
   : 'No recommendations await approval now.';
   // Get the file names of all queued and claimed jobs.
   const jobFileNames = await getJobNames();
@@ -116,16 +116,16 @@ const populateQuery = async query => {
     lines.tested.push(`${margin}    <li>URL: ${urlLink}</li>`);
     // Add facts about the report to the lines.
     lines.tested.push(`${margin}    <li>${testInfo}</li>`);
-    // If the page prevented any tool from performing its tests:
+    // If the page prevented any rule engine from performing its tests:
     if (preventedToolCount) {
       // Add this to the lines.
-      const toolCountString = getCountString(preventedToolCount, 'tool', 'tools');
+      const engineCountString = getCountString(preventedToolCount, 'rule engine', 'rule engines');
       lines.tested.push(
-        `${margin}    <li>Page not testable by ${toolCountString} (${preventedToolNames.join(' + ')})</li>`,
+        `${margin}    <li>Page not testable by ${engineCountString} (${preventedToolNames.join(' + ')})</li>`,
       );
     }
     // Add facts about the test results to the lines.
-     let reporterString = `${getCountString(reporterCount, 'tool', 'tools')} reported issues`;
+     let reporterString = `${getCountString(reporterCount, 'rule engine', 'rule engines')} reported issues`;
     if (reporterCount) {
       const reporterNamesString = reporterNames.join(' + ');
       reporterString = `${reporterString} (${reporterNamesString})`;
@@ -140,7 +140,7 @@ const populateQuery = async query => {
     // If any issues were reported:
     if (issueCount) {
       // Add a question link about the reported issues to the lines.
-      const href = `href="reportIssues.html/${timeStamp}/${jobID}"`;
+      const href = `href="listIssues.html/${timeStamp}/${jobID}"`;
       const label = `aria-label="What ${issueCountString} reported for the ${what} page?"`;
       const questionString = issueCount === 1 ? 'was the issue' : 'were the issues';
       const link = `<a ${href} ${label}>What ${questionString}?</a>`;
@@ -156,7 +156,7 @@ const populateQuery = async query => {
       retestString = 'Currently in the queue for retesting';
     }
     else {
-      const href = `/retestRecForm.html/${timeStamp}/${jobID}`;
+      const href = `/requestRetestForm.html/${timeStamp}/${jobID}`;
       const retestContent = 'Should Kilotest retest the page?';
       retestString = `<a href="${href}">${retestContent}</a>`;
     }

package/{rules → web/listRules}/index.js

@@ -1,6 +1,6 @@
 /*
   index.js
-  Answers the issue-rules question.
+  List the rules belonging to an issue.
 */
 
 // IMPORTS
@@ -9,7 +9,7 @@ const {
   getWeightName,
   htmlSafe,
   ruleEngines
-} = require('../util');
+} = require('../../util');
 const {issues: issueSpecs, issueRules, rules: ruleSpecs} = require('testaro-issues');
 const fs = require('fs/promises');
 const path = require('path');

package/{issues → web/listTopIssues}/index.js

@@ -1,11 +1,11 @@
 /*
   index.js
-  Answers the issues question.
+  Lists the most commonly reported issues in all available latest reports.
 */
 
 // IMPORTS
 
-const {sendAlert} = require('../alerts');
+const {sendAlert} = require('../../alerts');
 const {
   getLatestReportExtracts,
   getReport,
@@ -13,7 +13,7 @@ const {
   getWCAGLink,
   getWeightName,
   objectSort,
-} = require('../util');
+} = require('../../util');
 const {issues: issueSpecs} = require('testaro-issues');
 const fs = require('fs/promises');
 const path = require('path');
@@ -143,7 +143,7 @@ const populateQuery = async query => {
         lines.push(`${margin}    <ul class="nav">`);
         const linkText = 'What rules belong to this issue?';
         const label = `What rules belong to the <q>${summary}</q> issue?`;
-        const href = `/rules.html/${issueID}`;
+        const href = `/listRules.html/${issueID}`;
         lines.push(
           `${margin}      <li><a href="${href}" aria-label="${label}">${linkText}</a></li>`
         );

package/{reportIssue → web/listViolators}/index.js

@@ -1,6 +1,6 @@
 /*
   index.js
-  Answers the reportIssue question.
+  Lists the violators of an issue in a report.
 */
 
 // IMPORTS
@@ -16,7 +16,7 @@ const {
   htmlSafe,
   isHidden,
   makeBreakable,
-} = require('../util');
+} = require('../../util');
 const {issues: issueSpecs} = require('testaro-issues');
 const fs = require('fs/promises');
 const path = require('path');
@@ -151,7 +151,7 @@ const populateQuery = async (issueID, timeStamp, jobID, query) => {
       }
     }
     const href
-    = `/diagnoses.html/${issueID}/${timeStamp}/${jobID}/${catalogIndex}?pathID=${pathID}`;
+    = `/listDiagnoses.html/${issueID}/${timeStamp}/${jobID}/${catalogIndex}?pathID=${pathID}`;
     const questionString = 'What diagnoses were reported';
     const labelString = `${questionString} for violator ${index + 1}?`;
     lines.push(

package/{manage → web/manage}/index.html

@@ -15,17 +15,17 @@
       <h1><a href="/">Kilotest</a> management</h1>
       <p>Kilotest managers can:</p>
       <ul class="nav">
-        <li><a href="/recActionForm.html">Approve or reject a test recommendation</a></li>
+        <li><a href="/enqueueForm.html">Approve or reject a test recommendation</a></li>
         <li><a href="/reannotateForm.html">
           Reannotate reports to incorporate newly classified and reclassified rules
         </a></li>
-        <li><a href="/reportsPruneForm.html">Delete superseded reports</a></li>
-        <li><a href="/reportsRewindForm.html">Delete latest superseding reports</a></li>
-        <li><a href="/reportsExpungeForm.html">Delete sole reports</a></li>
-        <li><a href="/reportHideForm.html">Classify a report as experimental</a></li>
-        <li><a href="/reportUnhideForm.html">Declassify a report as experimental</a></li>
+        <li><a href="/pruneReportsForm.html">Delete superseded reports</a></li>
+        <li><a href="/rewindReportsForm.html">Delete latest superseding reports</a></li>
+        <li><a href="/expungeReportsForm.html">Delete sole reports</a></li>
+        <li><a href="/hideReportForm.html">Classify a report as experimental</a></li>
+        <li><a href="/unhideReportForm.html">Declassify a report as experimental</a></li>
         <li><a href="/ai0BalanceForm.html">Record the current balance of AI service 0</a></li>
-        <li><a href="/wcagRenewForm.html">Renew the map of WCAG numeric to text identifiers</a></li>
+        <li><a href="/renewWCAGForm.html">Renew the map of WCAG numeric to text identifiers</a></li>
       </ul>
     </main>
   </body>

package/{manage → web/manage}/index.js

@@ -1,6 +1,6 @@
 /*
   index.js
-  Answers the managers question.
+  Lists the actions that managers can take.
 */
 
 // IMPORTS

package/{reportsPruneForm → web/pruneReportsForm}/index.html

@@ -14,7 +14,7 @@
     <main>
       <h1><a href="/">Kilotest</a>: Prune reports</h1>
       <p>__intro__</p>
-      <form action="/reportsPruneForm.html">
+      <form action="/pruneReportsForm.html">
         <fieldset>
           <legend>Reports</legend>
           __reports__

package/{reportsPruneForm → web/pruneReportsForm}/index.js

@@ -5,7 +5,7 @@
 
 // IMPORTS
 
-const {getReportData, makeReportsExtract, reportsPath} = require('../util');
+const {getReportData, makeReportsExtract, reportsPath} = require('../../util');
 const fs = require('fs/promises');
 const path = require('path');
 

package/{reannotate → web/reannotate}/index.js

@@ -1,11 +1,11 @@
 /*
   index.js
-  Implements a reannotation order, i.e. an order to update the issue IDs of the standard instances of the latest reports on all tested targets.
+  Reannotates all available latest reports.
 */
 
 // IMPORTS
 
-const {annotateReport, getReportExtracts} = require('../util');
+const {annotateReport, getReportExtracts} = require('../../util');
 const fs = require('fs/promises');
 const path = require('path');
 

package/{reannotateForm → web/reannotateForm}/index.js

@@ -1,11 +1,11 @@
 /*
   index.js
-  Discloses unclassified and reclassified rules and serves a form to reannotate reports.
+  Serves a form to reannotate reports.
 */
 
 // IMPORTS
 
-const {getIssue, getReport, getReportExtracts} = require('../util');
+const {getIssue, getReport, getReportExtracts} = require('../../util');
 const fs = require('fs/promises');
 const path = require('path');
 

package/{wcagRenew → web/renewWCAG}/index.js

@@ -1,13 +1,13 @@
 /*
   index.js
-  Renews the WCAG map and serves an acknowledgment.
+  Renews the WCAG map.
 */
 
 // IMPORTS
 
 const fs = require('fs/promises');
 const path = require('path');
-const {getJSON} = require('../util');
+const {getJSON} = require('../../util');
 
 // FUNCTIONS
 
@@ -36,7 +36,7 @@ exports.answer = async authCode => {
           wcagMap[entry[2]] = entry[1];
         }
         // Save the map, replacing any existing one.
-        await fs.writeFile(path.join(__dirname, '..', 'wcagMap.json'), getJSON(wcagMap));
+        await fs.writeFile(path.join(__dirname, '..', '..', 'wcagMap.json'), getJSON(wcagMap));
         // Get the acknowledgment page.
         const answerPage = await fs.readFile(path.join(__dirname, 'index.html'), 'utf8');
         // Return it.

package/{wcagRenewForm → web/renewWCAGForm}/index.html

@@ -14,7 +14,7 @@
     <main>
       <h1><a href="/">Kilotest</a>: Renew WCAG map</h1>
       <p>Submit this form to renew the map of WCAG numeric to text identifiers.</p>
-      <form action="/wcagRenew.html" method="post">
+      <form action="/renewWCAG.html" method="post">
         <p><label>
           Authorization code: <input size="3" minLength="3" maxlength="3" name="authCode" required>
         </label></p>

package/{retestRec → web/requestRetest}/index.html

@@ -16,7 +16,7 @@
       <p>Your recommendation to retest the __target__ page has been received.</p>
       <p>The reason for your recommendation has been recorded as <q>__why__</q>.</p>
       <p>Thank you for your recommendation.</p>
-      <p>If a <a href="/recActionForm.html">Kilotest manager approves this recommendation</a>, a test order will be added to the queue.</p>
+      <p>If a <a href="/enqueueForm.html">Kilotest manager approves this recommendation</a>, a test order will be added to the queue.</p>
       <p>In most cases, if you check Kilotest again in 1 day, you will find that the recommended test has been performed.</p>
     </main>
   </body>

package/{retestRec → web/requestRetest}/index.js

@@ -1,15 +1,14 @@
 /*
   index.js
-  Answers the retest question.
+  Records a retest request.
 */
 
 // IMPORTS
 
-const {getLatestReportExtracts, processRec} = require('../util');
+const {getLatestReportExtracts, processTestRequest} = require('../../util');
 
 // FUNCTIONS
 
-// Records a retest recommendation and returns an acknowledgement page.
 exports.answer = async (pageArgs, why) => {
   const [timeStamp, jobID] = pageArgs.split('/');
   // Get data on the latest available reports.
@@ -27,6 +26,6 @@ exports.answer = async (pageArgs, why) => {
       message: error
     };
   }
-  // Otherwise, i.e. if it succeeded, process the recommendation.
-  return await processRec('retest', __dirname, what, url, why);
+  // Otherwise, i.e. if it succeeded, process the request.
+  return await processTestRequest('retest', __dirname, what, url, why);
 };

package/{retestRecForm → web/requestRetestForm}/index.html

@@ -13,9 +13,9 @@
   <body>
     <main>
       <h1><a href="/">Kilotest</a>: Retest recommendation for __target__</h1>
-      <p>The __target__ page was <a href="/reportIssues.html/__timeStamp__/__jobID__">last tested</a> __ago__ ago by job <code>__jobID__</code> on __dateTime__.</p>
+      <p>The __target__ page was <a href="/listIssues.html/__timeStamp__/__jobID__">last tested</a> __ago__ ago by job <code>__jobID__</code> on __dateTime__.</p>
       <p>To recommend a retest, submit the following form.</p>
-      <form action="/retestRec.html/__timeStamp__/__jobID__" method="post">
+      <form action="/requestRetest.html/__timeStamp__/__jobID__" method="post">
         <p><label>
           Why retest the page (answer required)?<br>
           <input size="70" minlength="5" maxlength="100" name="why" required>

package/{retestRecForm → web/requestRetestForm}/index.js

@@ -1,11 +1,11 @@
 /*
   index.js
-  Answers the retest question.
+  Serves a form for requesting a retest.
 */
 
 // IMPORTS
 
-const {getAgoString, getDateTimeString, getLatestReportExtracts} = require('../util');
+const {getAgoString, getDateTimeString, getLatestReportExtracts} = require('../../util');
 const fs = require('fs/promises');
 const path = require('path');
 

package/{testRec → web/requestTest}/index.html

@@ -16,7 +16,7 @@
       <p>Your recommendation to test the __target__ page has been received.</p>
       <p>The reason for your recommendation has been recorded as <q>__why__</q>.</p>
       <p>Thank you for your recommendation.</p>
-      <p>If a <a href="/recActionForm.html">Kilotest manager approves this recommendation</a>, a test order will be added to the queue.</p>
+      <p>If a <a href="/enqueueForm.html">Kilotest manager approves this recommendation</a>, a test order will be added to the queue.</p>
       <p>In most cases, if you check Kilotest again in 1 day, you will find that the recommended job has been performed.</p>
     </main>
   </body>

package/{testRec → web/requestTest}/index.js

@@ -1,18 +1,17 @@
 /*
   index.js
-  Processes a test recommendation.
+  Records a test request.
 */
 
 // IMPORTS
 
-const {isRecommendable, processRec} = require('../util');
+const {isRecommendable, processTestRequest} = require('../../util');
 
 // FUNCTIONS
 
-// Records a test recommendation and returns an acknowledgement page.
 exports.answer = async (what, url, why) => {
   const status = await isRecommendable(url);
-  // If the target is already claimed or queued and is thus not recommendable:
+  // If the target is already claimed or queued and is thus not requestable:
   if (status) {
     // Return an answer reporting this.
     return {
@@ -20,6 +19,6 @@ exports.answer = async (what, url, why) => {
       message: `Page is already ${status}`
     };
   }
-  // Otherwise, i.e. if it is recommendable, process the recommendation.
-  return await processRec('test', __dirname, what, url, why);
+  // Otherwise, i.e. if it is requestable, process the request.
+  return await processTestRequest('test', __dirname, what, url, why);
 };

package/{testRecForm → web/requestTestForm}/index.html

@@ -14,7 +14,7 @@
     <main>
       <h1><a href="/">Kilotest</a>: Test recommendation</h1>
       <p>You may recommend a web page for testing by submitting the following form. All answers are required.</p>
-      <form action="/testRec.html" method="post">
+      <form action="/requestTest.html" method="post">
         <p><label>
           Propose a name for the page.<br>
           <input size="50" maxlength="70" name="what" required>

package/{testRecForm → web/requestTestForm}/index.js

@@ -1,6 +1,6 @@
 /*
   index.js
-  Answers the test question.
+  Serves a form for requesting a test.
 */
 
 // IMPORTS
@@ -10,9 +10,8 @@ const path = require('path');
 
 // FUNCTIONS
 
-// Returns a test recommendation form.
 exports.answer = async () => {
-  // Get the recommendation form template.
+  // Get the test request form template.
   let answerPage = await fs.readFile(path.join(__dirname, 'index.html'), 'utf8');
   // Return it.
   return {

package/{reportsRewindForm → web/rewindReportsForm}/index.html

@@ -14,7 +14,7 @@
     <main>
       <h1><a href="/">Kilotest</a>: Rewind reports</h1>
       <p>__intro__</p>
-      <form action="/reportsRewindForm.html">
+      <form action="/rewindReportsForm.html">
         <fieldset>
           <legend>Reports</legend>
           __reports__

package/{reportsRewindForm → web/rewindReportsForm}/index.js

@@ -5,7 +5,7 @@
 
 // IMPORTS
 
-const {getReportData, reportsPath} = require('../util');
+const {getReportData, reportsPath} = require('../../util');
 const fs = require('fs/promises');
 const path = require('path');
 

package/{tutorial → web/tutorial}/index.js

@@ -1,12 +1,12 @@
 /*
   index.js
-  Answers the tutorial request and saves tutorial comments.
+  Serves the tutorial and saves tutorial comments.
 */
 
 // IMPORTS
 
-const {sendAlert} = require('../alerts');
-const {getJSON, getNowStamp} = require('../util');
+const {sendAlert} = require('../../alerts');
+const {getJSON, getNowStamp} = require('../../util');
 const fs = require('fs/promises');
 const path = require('path');
 

package/{reportUnhideForm → web/unhideReportForm}/index.html

@@ -14,7 +14,7 @@
     <main>
       <h1><a href="/">Kilotest</a>: Declassify report as experimental</h1>
       <p>Choose a report to declassify as experimental.</p>
-      <form action="/reportUnhideForm.html">
+      <form action="/unhideReportForm.html">
         <fieldset>
           <legend>Reports</legend>
           __reports__

package/{reportUnhideForm → web/unhideReportForm}/index.js

@@ -5,7 +5,7 @@
 
 // IMPORTS
 
-const {hiddenReportsPath, makeReportsExtract, reportsPath} = require('../util');
+const {hiddenReportsPath, makeReportsExtract, reportsPath} = require('../../util');
 const fs = require('fs/promises');
 const path = require('path');