@jrpool/kilotest 43.0.2 → 44.0.1

package/aceconfig.js

@@ -10,7 +10,7 @@
 
 /*
   aceconfig
-  Configuration for the ibm tool.
+  Configuration for the ibm rule engine.
 */
 
 const os = require('os');

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/AI-TOOLS.md

@@ -188,13 +188,13 @@ The [Perplexity documentation](https://www.perplexity.ai/help-center/en/articles
 
 Once the compatibility of Kilotest as a connector with AI platforms of two different vendors had been confirmed, the focus of work returned to completion of the missing endpoints of the API. The first was an endpoint that would let a model efficiently search for an available report about a particular web page.
 
-The new `summarizeQualityOfMatchingWebPages` tool provided inputs for fragments of a description and of a URL hostname of a web page and responds with summary data about all and only the available reports of pages that match at least one of those fragments, where matching means either including or being included by the provided fragment, case-insensitively.
+A new `summarizeQualityOfMatchingWebPages` tool provided inputs for fragments of a description and of a URL hostname of a web page and responds with summary data about all and only the available reports of pages that match at least one of those fragments, where matching means either including or being included by the provided fragment, case-insensitively.
 
 ### Increment 7
 
 Further experimentation made it clear that Increment 6 had been a detour. The problem with Increment 6 was that it does not improve efficiency by eliminating the need to get a list of all reports. Models must get a list of all reports in order to be confident that the answer to the question “Is a report available yet?” is correct. Any algorithm that matches a page description and a URL with those of existing reports is error-prone, organization names change, website designs change, URLs change, and organizations are related to one another. Typically, a desired report does not yet exist. In that case, the model needs the full list of reports in order to understand the naming convention for pages and to adhere to that convention when submitting a request to have the page of interest tested.
 
-For this reason, the tool being developed in increment 6 was deleted.
+For this reason, the tool developed in increment 6 was deleted.
 
 ### Increment 8
 

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
@@ -332,17 +332,17 @@ In case Testaro again becomes a dependency of Kilotest, the notes below on secur
 
 ### Browser privileges
 
-Testaro uses Playwright to launch and control headless browsers, often `chromium`. Those browsers navigate to web pages that are tested by the rule engines that Testaro integrates. The `qualWeb` tool launches its own browser via Puppeteer as a dependency to perform its tests.
+Testaro uses Playwright to launch and control headless browsers, often `chromium`. Those browsers navigate to web pages that are tested by the rule engines that Testaro integrates.
 
-When either Playwright or Puppeteer launches a `chromium` browser, in most environments it is [sandboxed](https://www.geeksforgeeks.org/ethical-hacking/what-is-browser-sandboxing/). Sandboxing is a security feature that prevents the browser from accessing potentially unsafe system resources. But in the Ubuntu Linux operating system that was installed on the Vultr Cloud Compute host a sandboxed browser requires an [unprivileged user namespace](https://ubuntu.com/blog/ubuntu-23-10-restricted-unprivileged-user-namespaces), and when Ubuntu was installed its configuration disallowed such namespaces. The file `/etc/sysctl.d/99-kilotest-userns.conf` with the content `kernel.apparmor_restrict_unprivileged_userns = 1` prohibited unprivileged user namespaces and thereby made sandboxed browsers unlaunchable.
+When Playwright (or Puppeteer) launches a `chromium` browser, in most environments it is [sandboxed](https://www.geeksforgeeks.org/ethical-hacking/what-is-browser-sandboxing/). Sandboxing is a security feature that prevents the browser from accessing potentially unsafe system resources. But in the Ubuntu Linux operating system that was installed on the Vultr Cloud Compute host a sandboxed browser requires an [unprivileged user namespace](https://ubuntu.com/blog/ubuntu-23-10-restricted-unprivileged-user-namespaces), and when Ubuntu was installed its configuration disallowed such namespaces. The file `/etc/sysctl.d/99-kilotest-userns.conf` with the content `kernel.apparmor_restrict_unprivileged_userns = 1` prohibited unprivileged user namespaces and thereby made sandboxed browsers unlaunchable.
 
 #### Potential modification
 
 One modification to cope with this prohibition on the Vultr Cloud Compute host would be to configure Playwright and Puppeteer to launch `chromium` non-sandboxed. In both cases, launch arguments `'--no-sandbox'` and `'--disable-setuid-sandbox'` are available to specify this.
 
 - For Playwright, `'--no-sandbox'` and `'--disable-setuid-sandbox'` would be added to the arguments of `browserOptionArgs.push` in the Testaro `run.js` file.
-- For the `qualWeb` tool, this would be done in the Testaro `tests/qualweb.js` file, where the `qualWeb.start` method is called with an options argument. Its `args` array property would include `'--no-sandbox'` and `'--disable-setuid-sandbox'`.
-- The `ibm` tool, too, could launch a Puppeteer `chromium` browser, if page content instead of a Playwright page were passed to the `accessibilityChecker.getCompliance` method, or if the implementation of the tool were changed in the future. For anticipation of such a case, the Testaro `aceconfig.js` file, of which a copy has been created at the root of the Kilotest project, would be modified. That file defines a `module.exports` object with a `puppeteerArgs` property, and, `--no-sandbox` and `--disable-setuid-sandbox` would be added to its array value.
+- For the `qualWeb` rule engine, this would be done in the Testaro `tests/qualweb.js` file, where the `qualWeb.start` method is called with an options argument. Its `args` array property would include `'--no-sandbox'` and `'--disable-setuid-sandbox'`.
+- The `ibm` rule engine, too, could launch a Puppeteer `chromium` browser, if page content instead of a Playwright page were passed to the `accessibilityChecker.getCompliance` method, or if the implementation of the rule engine were changed in the future. For anticipation of such a case, the Testaro `aceconfig.js` file, of which a copy has been created at the root of the Kilotest project, would be modified. That file defines a `module.exports` object with a `puppeteerArgs` property, and, `--no-sandbox` and `--disable-setuid-sandbox` would be added to its array value.
 
 #### Current modification
 

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

@@ -37,29 +37,29 @@ const path = require('path');
 const {sendAlert} = require('./alerts');
 const answer = {
   ai0BalanceForm: require('./web/ai0BalanceForm/index').answer,
-  diagnoses: require('./web/diagnoses/index').answer,
-  issues: require('./web/issues/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,
-  recActionForm: require('./web/recActionForm/index').answer,
-  reportIssue: require('./web/reportIssue/index').answer,
-  reportIssues: require('./web/reportIssues/index').answer,
-  reportsExpungeForm: require('./web/reportsExpungeForm/index').answer,
-  reportHideForm: require('./web/reportHideForm/index').answer,
-  reportsPruneForm: require('./web/reportsPruneForm/index').answer,
-  reportsRewindForm: require('./web/reportsRewindForm/index').answer,
-  reportUnhideForm: require('./web/reportUnhideForm/index').answer,
-  retestRec: require('./web/retestRec/index').answer,
-  retestRecForm: require('./web/retestRecForm/index').answer,
-  rules: require('./web/rules/index').answer,
-  targets: require('./web/targets/index').answer,
-  testOrder: require('./web/testOrder/index').answer,
-  testRec: require('./web/testRec/index').answer,
-  testRecForm: require('./web/testRecForm/index').answer,
-  tutorial: require('./web/tutorial/index').answer,
-  wcagRenew: require('./web/wcagRenew/index').answer,
-  wcagRenewForm: require('./web/wcagRenewForm/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
@@ -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, 'web', '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, 'web', '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, 'web', '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, 'web', '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);
           }
@@ -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, 'web', '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.2",
+  "version": "44.0.1",
   "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

@@ -27,7 +27,7 @@ const hiddenReportsPath = exports.hiddenReportsPath = path.join(dbPath, 'hiddenR
 // Path of the reports data file.
 const reportsExtractPath = exports.reportsExtractPath = path.join(dbPath, 'reportsExtract.json');
 // IDs, names, and sponsors of Testaro rule engines.
-const tools = exports.tools = {
+const ruleEngines = exports.ruleEngines = {
   alfa: ['Alfa', 'Siteimprove'],
   aslint: ['ASLint', 'eSSENTIAL Accessibility'],
   axe: ['Axe', 'Deque'],
@@ -41,7 +41,6 @@ const tools = exports.tools = {
   wave: ['WAVE', 'Utah State University'],
   wax: ['WallyAX', 'Wally']
 };
-exports.ruleEngines = tools;
 exports.researchAgents = {
   'research-agent': 'Internal Research Agent'
 }
@@ -252,13 +251,14 @@ exports.getTextFragmentHref = (text, url) => {
   return `${url}#:~:text=${fragmentList}`;
 };
 // Returns a +-delimited list of sorted names of rule engines.
-exports.getToolList = toolIDs => Array.from(toolIDs)
-.map(toolID => tools[toolID][0])
+exports.getEngineList = engineIDs => Array.from(engineIDs)
+.map(engineID => ruleEngines[engineID][0])
 .sort((a, b) => a.localeCompare(b, 'en', {sensitivity: 'base'}))
 .join(' + ');
 // Returns a string of names of rule engines.
-exports.getToolNamesString = toolIDSet =>
-  alphaSort(Array.from(toolIDSet).map(toolID => tools[toolID]?.[0] || toolID)).join(' + ');
+exports.getEngineNamesString = engineIDSet => alphaSort(
+  Array.from(engineIDSet).map(engineID => ruleEngines[engineID]?.[0] || engineID)
+).join(' + ');
 // Gets the WCAG Understanding link for a numeric WCAG standard identifier.
 exports.getWCAGLink = numericID => {
   // Return the link.
@@ -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
@@ -444,7 +444,7 @@ const isValidReport = exports.isValidReport = report => {
   && report.acts.every(act =>
     typeof act === 'object'
     && typeof act.type === 'string'
-    && act.type === 'test' ? Object.keys(tools).includes(act.which) : true
+    && act.type === 'test' ? Object.keys(ruleEngines).includes(act.which) : true
   )
   && typeof report.jobData === 'object'
   && report.jobData.endTime
@@ -536,16 +536,16 @@ exports.getReportData = async (timeStamp, jobID) => {
     creationDate: getDateTime(timeStamp),
     daysAgo: getAgoDays(timeStamp),
     issueCount: 0,
-    toolNames: [],
-    toolCount: 0,
+    engineNames: [],
+    engineCount: 0,
     reporterNames: [],
     reporterCount: 0,
     violatorCount: 0,
-    preventedToolNames: [],
-    preventedToolCount: 0
+    preventedEngineNames: [],
+    preventedEngineCount: 0
   };
   const issueIDSet = new Set();
-  const toolNameSet = new Set();
+  const engineNameSet = new Set();
   const reporterIDSet = new Set();
   const violatorIndexSet = new Set();
   // For each act of the report:
@@ -553,15 +553,15 @@ exports.getReportData = async (timeStamp, jobID) => {
     // If it is a test act:
     if (act.type === 'test') {
       const {result, which} = act;
-      // Ensure that the tool is in the temporary data.
-      toolNameSet.add(tools[which][0]);
+      // Ensure that the rule engine is in the temporary data.
+      engineNameSet.add(ruleEngines[which][0]);
       const instances = result?.standardResult?.instances ?? [];
       // For each standard instance of the act:
       instances.forEach(instance => {
         const {catalogIndex, issueID} = instance;
         // If it has a non-ignorable classified issue ID:
         if (issueID && issueSpecs[issueID] && issueID !== 'ignorable') {
-          // Ensure that the tool is in the temporary data.
+          // Ensure that the rule engine is in the temporary data.
           reporterIDSet.add(which);
           // Ensure that the issue is in the temporary data.
           issueIDSet.add(issueID);
@@ -576,21 +576,21 @@ exports.getReportData = async (timeStamp, jobID) => {
   });
   // Populate the data with the act data.
   data.issueCount = issueIDSet.size;
-  data.toolNames = Array
-  .from(toolNameSet)
+  data.engineNames = Array
+  .from(engineNameSet)
   .sort((a, b) => a.localeCompare(b, 'en', {sensitivity: 'base'}));
-  data.toolCount = toolNameSet.size;
+  data.engineCount = engineNameSet.size;
   data.reporterNames = Array
   .from(reporterIDSet)
-  .map(id => tools[id][0])
+  .map(id => ruleEngines[id][0])
   .sort((a, b) => a.localeCompare(b, 'en', {sensitivity: 'base'}));
   data.reporterCount = data.reporterNames.length;
   data.violatorCount = violatorIndexSet.size;
   // Add the names of any prevented rule engines to the data.
-  data.preventedToolNames = Object.keys(report.jobData?.preventions || {})
-  .map(toolID => tools[toolID][0])
+  data.preventedEngineNames = Object.keys(report.jobData?.preventions || {})
+  .map(engineID => ruleEngines[engineID][0])
   .sort((a, b) => a.localeCompare(b, 'en', {sensitivity: 'base'}));
-  data.preventedToolCount = data.preventedToolNames.length;
+  data.preventedEngineCount = data.preventedEngineNames.length;
   // Return the data.
   return data;
 }

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

@@ -1,17 +1,19 @@
 /*
   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) {
@@ -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));