@jrpool/kilotest 55.0.0 → 57.0.1

package/index.test.ts

@@ -24,7 +24,7 @@ process.env.TESTARO_WORKERS = JSON.stringify({
 // isAllowedTarget performs. Tests of the check itself (below) override this per test.
 process.env.ALLOW_INTERNAL_TARGETS = 'true';
 // Blank the alert configuration unconditionally, so this file sends no real alert
-// emails (e.g. from the requestTest/requestRetest/tutorial-comment tests below) even
+// emails (e.g. from the requestNewTest/requestRetest/tutorial-comment tests below) even
 // when run directly (e.g. `npx tsx --test index.test.ts`) rather than via `npm test`,
 // which normally guards against this by --require-ing test/setup.ts first. dotenv does
 // not override an already-set env var, so setting these here, before index.ts is ever
@@ -459,8 +459,8 @@ test('GET /forbidden-path returns an invalid GET request error', async () => {
 
 // TESTS: POST routes
 
-test('POST /requestTest.html with valid data returns an HTML page', async () => {
-  const res = await formRequest('POST', '/requestTest.html', {
+test('POST /requestNewTest.html with valid data returns an HTML page', async () => {
+  const res = await formRequest('POST', '/requestNewTest.html', {
     description: `Unique Test Page ${uniqueStamp}`,
     url: `https://example.com/unique-${uniqueStamp}`,
     why: 'Because accessibility matters'
@@ -469,8 +469,8 @@ test('POST /requestTest.html with valid data returns an HTML page', async () =>
   assert.ok(res.headers['content-type'].includes('text/html'));
 });
 
-test('POST /requestTest.html with an already-tested URL returns an error', async () => {
-  const res = await formRequest('POST', '/requestTest.html', {
+test('POST /requestNewTest.html with an already-tested URL returns an error', async () => {
+  const res = await formRequest('POST', '/requestNewTest.html', {
     description: 'Mixed Outcomes Page',
     url: 'https://example.com/mixed',
     why: 'Because accessibility matters'
@@ -479,8 +479,8 @@ test('POST /requestTest.html with an already-tested URL returns an error', async
   assert.ok(res.body.includes('already been tested'));
 });
 
-test('POST /requestTest.html with invalid data returns an error', async () => {
-  const res = await formRequest('POST', '/requestTest.html', {
+test('POST /requestNewTest.html with invalid data returns an error', async () => {
+  const res = await formRequest('POST', '/requestNewTest.html', {
     description: '',
     url: 'not-a-url',
     why: ''
@@ -489,8 +489,8 @@ test('POST /requestTest.html with invalid data returns an error', async () => {
   assert.ok(res.body.includes('Invalid test request'));
 });
 
-test('POST /requestTest.html with an unreadable body returns an error', async () => {
-  const res = await request('POST', '/requestTest.html', 'rawbody', {'content-type': 'text/plain'});
+test('POST /requestNewTest.html with an unreadable body returns an error', async () => {
+  const res = await request('POST', '/requestNewTest.html', 'rawbody', {'content-type': 'text/plain'});
   assert.equal(res.statusCode, 400);
   assert.ok(res.body.includes('Unreadable request body'));
 });
@@ -513,8 +513,8 @@ test('POST /requestRetest.html/invalid/invalid with invalid data returns an erro
   assert.ok(res.body.includes('Invalid retest request'));
 });
 
-test('POST /api/requestTest with valid JSON returns a JSON response', {timeout: 500}, async () => {
-  const res = await request('POST', '/api/requestTest', {
+test('POST /api/requestNewTest with valid JSON returns a JSON response', {timeout: 500}, async () => {
+  const res = await request('POST', '/api/requestNewTest', {
     description: `API Test Page ${uniqueStamp}`,
     URL: `https://example.com/api-test-${uniqueStamp}`,
     reason: 'Because accessibility matters'
@@ -544,6 +544,45 @@ test('POST /api/requestFeature with valid JSON returns a JSON response and recor
   assert.equal(await getMetricCount('apiOperations', 'requestFeature'), countBefore + 1);
 });
 
+test('POST /api/orderNewTest with valid JSON enqueues a job directly and records an API-operation metric', {timeout: 500}, async () => {
+  const countBefore = await getMetricCount('apiOperations', 'orderNewTest');
+  const res = await request('POST', '/api/orderNewTest', {
+    description: `API Ordered Page ${uniqueStamp}`,
+    URL: `https://example.com/api-ordered-${uniqueStamp}`,
+    reason: 'Because accessibility matters here'
+  });
+  assert.equal(res.statusCode, 200);
+  const body = jsonBody(res);
+  assert.ok(body['tool name'] || body['response content']);
+  assert.equal(await getMetricCount('apiOperations', 'orderNewTest'), countBefore + 1);
+  const reportIdentifier = body['response content']['disposition of your order']['report identifier'];
+  assert.ok(reportIdentifier);
+  await fs.unlink(path.join(fixtureDBDir, 'jobs', 'queue', `${reportIdentifier.timeStamp}-${reportIdentifier.jobID}.json`));
+});
+
+test('POST /api/orderRetest/260202T0000/new with valid JSON enqueues a job directly and records an API-operation metric', async () => {
+  const countBefore = await getMetricCount('apiOperations', 'orderRetest');
+  const res = await request('POST', '/api/orderRetest/260202T0000/new', {
+    reason: 'Because the report is obsolete and needs refreshing'
+  });
+  assert.equal(res.statusCode, 200);
+  const body = jsonBody(res);
+  assert.ok(body['tool name'] || body['response content']);
+  assert.equal(await getMetricCount('apiOperations', 'orderRetest'), countBefore + 1);
+  const reportIdentifier = body['response content']['disposition of your order']['report identifier'];
+  assert.ok(reportIdentifier);
+  await fs.unlink(path.join(fixtureDBDir, 'jobs', 'queue', `${reportIdentifier.timeStamp}-${reportIdentifier.jobID}.json`));
+});
+
+test('POST /api/awaitTest/260101T0000/mix with an already-completed report records an API-operation metric', async () => {
+  const countBefore = await getMetricCount('apiOperations', 'awaitTest');
+  const res = await request('POST', '/api/awaitTest/260101T0000/mix', {});
+  assert.equal(res.statusCode, 200);
+  const body = jsonBody(res);
+  assert.equal(body['response content']['disposition of your wait'].outcome, 'completed');
+  assert.equal(await getMetricCount('apiOperations', 'awaitTest'), countBefore + 1);
+});
+
 test('POST /api/invalidService returns an error', async () => {
   const res = await request('POST', '/api/invalidService', {data: 'test'});
   assert.equal(res.statusCode, 400);
@@ -697,7 +736,7 @@ test('POST /requestAction.html with invalid auth code returns an error and recor
 });
 
 test('POST /requestAction.html with valid auth code and rejection (no description) returns HTML and records a managerActivity success', async () => {
-  await formRequest('POST', '/requestTest.html', {
+  await formRequest('POST', '/requestNewTest.html', {
     description: `Reject Test Page ${uniqueStamp}`,
     url: `https://example.com/reject-${uniqueStamp}`,
     why: 'Because accessibility matters'
@@ -740,7 +779,7 @@ test('GET /fullReport.json/260101T0007/hid returns an error for an unavailable r
 
 test('POST /requestAction.html with valid auth code and approval returns HTML', {timeout: 500}, async () => {
   await fs.writeFile(testRequestsPath, '{}\n');
-  await formRequest('POST', '/requestTest.html', {
+  await formRequest('POST', '/requestNewTest.html', {
     description: `Approval Test Page ${uniqueStamp}`,
     url: `https://example.com/approval-${uniqueStamp}`,
     why: 'Because accessibility matters'
@@ -899,8 +938,40 @@ test('GET /targets.html redirects to /listReports.html', async () => {
   assert.equal(res.headers['location'], '/listReports.html');
 });
 
-test('POST /requestTest.html with non-https URL returns an error', async () => {
-  const res = await formRequest('POST', '/requestTest.html', {
+test('GET /requestTest.html redirects to /requestNewTest.html', async () => {
+  const res = await request('GET', '/requestTest.html', {}, {followRedirects: false});
+  assert.equal(res.statusCode, 301);
+  assert.equal(res.headers['location'], '/requestNewTest.html');
+});
+
+test('GET /requestTestForm.html redirects to /requestNewTestForm.html', async () => {
+  const res = await request('GET', '/requestTestForm.html', {}, {followRedirects: false});
+  assert.equal(res.statusCode, 301);
+  assert.equal(res.headers['location'], '/requestNewTestForm.html');
+});
+
+test('POST /api/requestTest redirects (308, preserving method) to /api/requestNewTest', async () => {
+  const res = await request('POST', '/api/requestTest', {
+    description: `Old Path Page ${uniqueStamp}`,
+    URL: `https://example.com/old-path-${uniqueStamp}`,
+    reason: 'Because accessibility matters'
+  }, {followRedirects: false});
+  assert.equal(res.statusCode, 308);
+  assert.equal(res.headers['location'], '/api/requestNewTest');
+});
+
+test('POST /api/orderTest redirects (308, preserving method) to /api/orderNewTest', async () => {
+  const res = await request('POST', '/api/orderTest', {
+    description: `Old Path Ordered Page ${uniqueStamp}`,
+    URL: `https://example.com/old-path-ordered-${uniqueStamp}`,
+    reason: 'Because accessibility matters'
+  }, {followRedirects: false});
+  assert.equal(res.statusCode, 308);
+  assert.equal(res.headers['location'], '/api/orderNewTest');
+});
+
+test('POST /requestNewTest.html with non-https URL returns an error', async () => {
+  const res = await formRequest('POST', '/requestNewTest.html', {
     description: 'Test Page',
     url: 'http://example.com',
     why: 'Because accessibility matters'
@@ -909,10 +980,10 @@ test('POST /requestTest.html with non-https URL returns an error', async () => {
   assert.ok(res.body.includes('Invalid test request'));
 });
 
-test('POST /requestTest.html with a private-address URL returns an error unless internal targets are allowed', async () => {
+test('POST /requestNewTest.html with a private-address URL returns an error unless internal targets are allowed', async () => {
   delete process.env.ALLOW_INTERNAL_TARGETS;
   try {
-    const res = await formRequest('POST', '/requestTest.html', {
+    const res = await formRequest('POST', '/requestNewTest.html', {
       description: 'Internal Page',
       url: 'https://192.168.1.1/page',
       why: 'Because accessibility matters'
@@ -1370,14 +1441,14 @@ test('GET /style.css with a read error returns an error page', async () => {
   }
 });
 
-// requestTest.html and requestRetest.html are POST-only routes (see the
+// requestNewTest.html and requestRetest.html are POST-only routes (see the
 // `routes.POST` list above). They also match the generic '*.html*' GET pattern,
 // but the generic `pageName.endsWith('.html')` branch of the GET dispatcher
 // excludes any path that is POST-only, since such a path's answer handler
 // expects POST's argument list and performs no GET-appropriate rendering.
 
-test('GET /requestTest.html without arguments is rejected as an invalid GET request', async () => {
-  const res = await request('GET', '/requestTest.html');
+test('GET /requestNewTest.html without arguments is rejected as an invalid GET request', async () => {
+  const res = await request('GET', '/requestNewTest.html');
   assert.equal(res.statusCode, 400);
 });
 
@@ -1731,18 +1802,18 @@ test('POST /mcp with a valid initialize request returns server info via SSE', as
 
 // TESTS: answer error branches
 
-test('POST /requestTest.html with valid format but duplicate URL returns an answer error', {timeout: 500}, async () => {
+test('POST /requestNewTest.html with valid format but duplicate URL returns an answer error', {timeout: 500}, async () => {
   await fs.writeFile(testRequestsPath, '{}\n');
   // First request to create the request. processTestRequest treats a request as a
   // duplicate only when description, URL, AND reason all match an existing pending
   // request, so the reason must be identical between the two requests here.
-  await formRequest('POST', '/requestTest.html', {
+  await formRequest('POST', '/requestNewTest.html', {
     description: `Dup Test Page ${uniqueStamp}`,
     url: `https://example.com/dup-${uniqueStamp}`,
     why: 'Because accessibility matters'
   });
   // Second, identical request should get a duplicate error.
-  const res = await formRequest('POST', '/requestTest.html', {
+  const res = await formRequest('POST', '/requestNewTest.html', {
     description: `Dup Test Page ${uniqueStamp}`,
     url: `https://example.com/dup-${uniqueStamp}`,
     why: 'Because accessibility matters'
@@ -1770,7 +1841,7 @@ test('POST /requestRetest.html with valid format but duplicate retest returns an
 test('POST /requestAction.html with valid auth code approves the same target twice without error', {timeout: 500}, async () => {
   await fs.writeFile(testRequestsPath, '{}\n');
   // Create a request.
-  await formRequest('POST', '/requestTest.html', {
+  await formRequest('POST', '/requestNewTest.html', {
     description: `Action Dup Page ${uniqueStamp}`,
     url: `https://example.com/action-dup-${uniqueStamp}`,
     why: 'Because accessibility matters'

package/index.ts

@@ -67,8 +67,8 @@ import {answer as renewWCAG} from './web/renewWCAG/index.ts';
 import {answer as renewWCAGForm} from './web/renewWCAGForm/index.ts';
 import {answer as requestRetestPage} from './web/requestRetest/index.ts';
 import {answer as requestRetestForm} from './web/requestRetestForm/index.ts';
-import {answer as requestTestPage} from './web/requestTest/index.ts';
-import {answer as requestTestForm} from './web/requestTestForm/index.ts';
+import {answer as requestNewTestPage} from './web/requestNewTest/index.ts';
+import {answer as requestNewTestForm} from './web/requestNewTestForm/index.ts';
 import {answer as rewindReportsForm} from './web/rewindReportsForm/index.ts';
 import {answer as showHiddenReportsForm} from './web/showHiddenReportsForm/index.ts';
 import {answer as unhideReportForm} from './web/unhideReportForm/index.ts';
@@ -79,7 +79,10 @@ import {response as listReportsAPI} from './api/listReports.ts';
 import {response as listViolatorsAPI} from './api/listViolators.ts';
 import {response as requestFeatureAPI} from './api/requestFeature.ts';
 import {response as requestRetestAPI} from './api/requestRetest.ts';
-import {response as requestTestAPI} from './api/requestTest.ts';
+import {response as requestNewTestAPI} from './api/requestNewTest.ts';
+import {response as orderNewTestAPI} from './api/orderNewTest.ts';
+import {response as orderRetestAPI} from './api/orderRetest.ts';
+import {response as awaitTestAPI} from './api/awaitTest.ts';
 
 // ENVIRONMENT
 
@@ -124,8 +127,8 @@ const answer: {
   renewWCAGForm: PageHandler;
   requestRetest: PageHandler;
   requestRetestForm: PageHandler;
-  requestTest: PageHandler;
-  requestTestForm: PageHandler;
+  requestNewTest: PageHandler;
+  requestNewTestForm: PageHandler;
   rewindReportsForm: PageHandler;
   showHiddenReportsForm: PageHandler;
   unhideReportForm: PageHandler;
@@ -154,8 +157,8 @@ const answer: {
   renewWCAGForm,
   requestRetest: requestRetestPage,
   requestRetestForm,
-  requestTest: requestTestPage,
-  requestTestForm,
+  requestNewTest: requestNewTestPage,
+  requestNewTestForm,
   rewindReportsForm,
   showHiddenReportsForm,
   unhideReportForm
@@ -170,7 +173,10 @@ const apiRespond: {
   listViolators: ApiResponder;
   requestFeature: ApiResponder;
   requestRetest: ApiResponder;
-  requestTest: ApiResponder;
+  requestNewTest: ApiResponder;
+  orderNewTest: ApiResponder;
+  orderRetest: ApiResponder;
+  awaitTest: ApiResponder;
 } = {
   getReport: getReportAPI,
   listDiagnoses: listDiagnosesAPI,
@@ -179,7 +185,10 @@ const apiRespond: {
   listViolators: listViolatorsAPI,
   requestFeature: requestFeatureAPI,
   requestRetest: requestRetestAPI,
-  requestTest: requestTestAPI
+  requestNewTest: requestNewTestAPI,
+  orderNewTest: orderNewTestAPI,
+  orderRetest: orderRetestAPI,
+  awaitTest: awaitTestAPI
 };
 
 // CONSTANTS
@@ -226,7 +235,7 @@ export const routes = {
     '/requestAction.html',
     '/renewWCAG.html',
     '/requestRetest.html/*',
-    '/requestTest.html',
+    '/requestNewTest.html',
     '/tutorialWebComment.html',
     '/unhideReportForm.html',
     '/worker/job',
@@ -276,12 +285,18 @@ const noDirectGetPages = new Set(['unhideReportForm']);
 // engines and other crawlers are still requesting. Redirecting them lets crawlers update
 // their own indexes, rather than leaving them to repeat the same dead request indefinitely.
 // TEMPORARY: retire this redirect after 2027-04-01 once crawlers have re-indexed.
+// requestTest and requestTestForm were renamed to requestNewTest and requestNewTestForm
+// on 2026-09-28 (see the newTest/retest naming-ambiguity fix), to distinguish the
+// new-test-only page from bare "test" language used elsewhere.
+// TEMPORARY: retire this redirect after 2027-03-28 once crawlers have re-indexed.
 const renamedPagePrefixes: Record<string, string> = {
   diagnoses: 'listDiagnoses',
   reportIssue: 'listViolators',
   reportIssues: 'listIssues',
   rules: 'listRules',
-  targets: 'listReports'
+  targets: 'listReports',
+  requestTest: 'requestNewTest',
+  requestTestForm: 'requestNewTestForm'
 };
 const jobLock = createLock();
 
@@ -927,7 +942,7 @@ const handleRequest = async (request: IncomingMessage, response: ServerResponse)
         await serveError({message: 'ERROR: Unreadable request body'}, response, true);
       }
       // If the request is a test request:
-      else if (pageName === 'requestTest.html') {
+      else if (pageName === 'requestNewTest.html') {
         const {description, url, why} = postData as {description?: string; url: string; why?: string};
         // If the request is valid:
         if (description && isURL(url) && why && await isAllowedTarget(url)) {
@@ -941,7 +956,7 @@ const handleRequest = async (request: IncomingMessage, response: ServerResponse)
             // Serve headers for a response.
             setHeaders('text/html', pathname, 'ultra');
             // Get the answer data.
-            const answerData = await answer.requestTest(description, url, why);
+            const answerData = await answer.requestNewTest(description, url, why);
             // If they are valid:
             if (answerData.status === 'ok') {
               // Serve the answer page.
@@ -1226,15 +1241,26 @@ const handleRequest = async (request: IncomingMessage, response: ServerResponse)
         // Get the segments of the path after api.
         const segments = pathTail.split('/');
         // If the service is to receive a test request:
-        if (segments[0] === 'requestTest') {
+        if (segments[0] === 'requestNewTest') {
           const {description, URL, reason} = postData as {description: string; URL: string; reason: string};
           // Get the response body.
-          const responseBody = await apiRespond.requestTest([description, URL, reason]);
-          await recordPageMetric('apiOperations', 'requestTest');
+          const responseBody = await apiRespond.requestNewTest([description, URL, reason]);
+          await recordPageMetric('apiOperations', 'requestNewTest');
           // Send it.
           setHeaders('application/json', null, 'ultra');
           response.end(JSON.stringify(responseBody));
         }
+        // Otherwise, if the request uses the old, pre-rename requestTest path name: redirect
+        // permanently to the new path name. requestTest takes no path parameters (its
+        // arguments are body fields), so there is no further path to preserve, unlike the
+        // renamedPagePrefixes GET-page redirects above. 308 (not 301) is used here because
+        // 301 is defined to let clients rewrite a POST redirect as a GET, which would drop
+        // this request's body; 308 preserves both the method and the body.
+        // TEMPORARY: retire this redirect after 2027-03-28 once callers have updated.
+        else if (segments[0] === 'requestTest') {
+          response.writeHead(308, {Location: '/api/requestNewTest'});
+          response.end();
+        }
         // Otherwise, if the service is to receive a retest request:
         else if (segments[0] === 'requestRetest') {
           const {reason} = postData as {reason: string};
@@ -1255,6 +1281,44 @@ const handleRequest = async (request: IncomingMessage, response: ServerResponse)
           setHeaders('application/json', null, 'ultra');
           response.end(JSON.stringify(responseBody));
         }
+        // Otherwise, if the service is to order an immediate, automatically approved test:
+        else if (segments[0] === 'orderNewTest') {
+          const {description, URL, reason} = postData as {description: string; URL: string; reason: string};
+          // Get the response body.
+          const responseBody = await apiRespond.orderNewTest([description, URL, reason]);
+          await recordPageMetric('apiOperations', 'orderNewTest');
+          // Send it.
+          setHeaders('application/json', null, 'ultra');
+          response.end(JSON.stringify(responseBody));
+        }
+        // Otherwise, if the request uses the old, pre-rename orderTest path name: redirect
+        // permanently to the new path name. orderTest likewise takes no path parameters.
+        // See the requestTest redirect above for why 308 (not 301) is used for these
+        // POST-only API redirects.
+        // TEMPORARY: retire this redirect after 2027-03-28 once callers have updated.
+        else if (segments[0] === 'orderTest') {
+          response.writeHead(308, {Location: '/api/orderNewTest'});
+          response.end();
+        }
+        // Otherwise, if the service is to order an immediate, automatically approved retest:
+        else if (segments[0] === 'orderRetest') {
+          const {reason} = postData as {reason: string};
+          // Get the response body.
+          const responseBody = await apiRespond.orderRetest(segments.slice(1).concat(reason));
+          await recordPageMetric('apiOperations', 'orderRetest');
+          // Send it.
+          setHeaders('application/json', null, 'ultra');
+          response.end(JSON.stringify(responseBody));
+        }
+        // Otherwise, if the service is to wait for an ordered job to complete:
+        else if (segments[0] === 'awaitTest') {
+          // Get the response body.
+          const responseBody = await apiRespond.awaitTest(segments.slice(1));
+          await recordPageMetric('apiOperations', 'awaitTest');
+          // Send it.
+          setHeaders('application/json', null, 'ultra');
+          response.end(JSON.stringify(responseBody));
+        }
         // Otherwise, i.e. if the service is invalid:
         else {
           await serveError(

package/lhm.plugin.json

@@ -2297,7 +2297,7 @@
       }
     },
     {
-      "name": "requestTest",
+      "name": "requestNewTest",
       "description": "Process my request to test a page about which no report is available yet.",
       "inputSchema": {
         "type": "object",

package/linkValidation.test.ts

@@ -48,8 +48,8 @@ const htmlRoutes = [
   '/listViolators.html',
   '/listRules.html',
   '/manage.html',
-  '/requestTest.html',
-  '/requestTestForm.html',
+  '/requestNewTest.html',
+  '/requestNewTestForm.html',
   '/requestRetest.html',
   '/requestRetestForm.html',
   '/reannotate.html',

package/llms-full.txt

@@ -63,7 +63,7 @@ Kilotest offers a comprehensive suite of capabilities to users via its web UI:
 - 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 testing of a not-yet-tested page](https://kilotest.com/requestNewTestForm.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)
@@ -108,10 +108,10 @@ Kilotest offers these tools:
     - `timeStamp`: initial segment of report identifier
     - `jobID`: final segment of report identifier
   - source of parameters: response to a `listViolators` request
-- `requestTest`
+- `requestNewTest`
   - method: `POST`
   - purpose: request testing of one web page about which no report is available
-  - path: `/api/requestTest`
+  - path: `/api/requestNewTest`
   - payload properties
     - `description`: description of the page to be tested
     - `URL`: URL of the page to be tested
@@ -132,6 +132,35 @@ Kilotest offers these tools:
   - path: `/api/requestFeature`
   - payload properties
     - `feature`: description and motivation of the feature improvement or the new feature
+- `orderNewTest`
+  - method: `POST`
+  - purpose: order immediate, automatically approved testing of one web page about which no report is available, instead of waiting for manual approval
+  - path: `/api/orderNewTest`
+  - payload properties
+    - `description`: description of the page to be tested
+    - `URL`: URL of the page to be tested
+    - `reason`: reason for testing the page
+  - response includes a report identifier (`timeStamp` and `jobID`) once the job is enqueued
+- `orderRetest`
+  - method: `POST`
+  - purpose: order immediate, automatically approved retesting of one web page about which a report is available, instead of waiting for manual approval
+  - path: `/api/orderRetest/{timeStamp}/{jobID}`
+  - parameters
+    - `timeStamp`: initial segment of report identifier
+    - `jobID`: final segment of report identifier
+  - source of parameters: response to a `listIssues` request
+  - payload properties
+    - `reason`: reason for retesting the page
+  - response includes a report identifier (`timeStamp` and `jobID`) once the job is enqueued
+- `awaitTest`
+  - method: `POST`
+  - purpose: wait for a job ordered via `orderNewTest` or `orderRetest` to complete; blocks until the report is ready, the job fails, or a maximum wait time elapses, then returns
+  - path: `/api/awaitTest/{timeStamp}/{jobID}`
+  - parameters
+    - `timeStamp`: initial segment of the report identifier returned by `orderNewTest` or `orderRetest`
+    - `jobID`: final segment of the report identifier returned by `orderNewTest` or `orderRetest`
+  - source of parameters: response to an `orderNewTest` or `orderRetest` request
+  - caveat: testing typically takes about 2 minutes and occasionally up to 4 minutes; sends no interim notices while waiting
 
 ## After a test, retest, or feature request
 
@@ -147,6 +176,8 @@ When you request a test or a retest:
   - 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/listReports.html`
 
+For immediate testing without waiting for manual approval, use `orderNewTest` or `orderRetest` instead of `requestNewTest` or `requestRetest`. Each enqueues the job right away and returns a report identifier along with a question about whether to wait for completion. To wait, call `awaitTest` with that identifier; it blocks until the report is ready, the job fails, or a maximum wait time elapses. To check later instead, call `listIssues` with the same identifier.
+
 An [OpenAPI specification for Kilotest](https://kilotest.com/openapi.yaml) is available.
 
 ## How to report results honestly to users

package/llms.txt

@@ -9,9 +9,12 @@ Kilotest helps language models and AI platforms to give thorough, accurate and t
 - List all elements exhibiting one issue in one report: `/api/listViolators/{issueID}/{timeStamp}/{jobID}` (`GET`)
 - List all diagnoses of one element exhibiting one issue in one report: `/api/listDiagnoses/{catalogIndex}/{issueID}/{timeStamp}/{jobID}` (`GET`)
 - Get one full report in JSON: `/api/getReport/{timeStamp}/{jobID}` (`GET`)
-- Request testing of a web page: `/api/requestTest` (`POST`)
+- Request testing of a web page: `/api/requestNewTest` (`POST`)
 - Request retesting of a web page: `/api/requestRetest/{timeStamp}/{jobID}` (`POST`)
 - Request adding or improving a feature: `/api/requestFeature` (`POST`)
+- Order immediate, automatically approved testing of a web page: `/api/orderNewTest` (`POST`)
+- Order immediate, automatically approved retesting of a web page: `/api/orderRetest/{timeStamp}/{jobID}` (`POST`)
+- Wait for a job ordered via orderNewTest or orderRetest to complete: `/api/awaitTest/{timeStamp}/{jobID}` (`POST`)
 
 ## MCP Server
 
@@ -24,7 +27,7 @@ Kilotest helps language models and AI platforms to give thorough, accurate and t
 - 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/requestTestForm.html)
+- [Request testing of a web page](https://kilotest.com/requestNewTestForm.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/listTopIssues.html)