@jrpool/kilotest 58.2.4 → 59.0.2

package/api/util.ts

@@ -15,7 +15,7 @@ import {
   objectSort,
   ruleEngines
 } from '../util.ts';
-import type {ReportExtract, TestRequestResult} from '../util.ts';
+import type {TestRequestResult} from '../util.ts';
 import {issues as issueSpecs} from 'testaro-issues';
 
 // TYPES
@@ -51,9 +51,9 @@ export const getResponseMetadata = () => ({
 export const getToolsFacts = () => ({
   'name': 'Kilotest',
   'description': {
-    'what Kilotest does': 'Kilotest tools generate and make available findings about the front-end quality (i.e. accessibility, usability, and standards conformity) of web pages. A Kilotest job generates findings by using Testaro to test a page against about 1300 rules defined by an ensemble of twelve rule engines. Testaro produces a report of the job. The report describes violations of the rules. Kilotest uses Testilo to enhance the report with a classification of the rule violations into about 380 issues. Kilotest makes facts about the issues and the violations retrievable at four levels of granularity.',
+    'what Kilotest does': 'Kilotest tools generate and make available findings about the front-end quality (i.e. accessibility, usability, and standards conformity) of web pages. A Kilotest job generates findings by using Testaro to test a page against about 1300 rules defined by an ensemble of twelve rule engines. Testaro produces a report of the job. The report describes violations of the rules. Kilotest uses Testilo to enhance the report with a classification of the rule violations into about 380 issues. Kilotest makes facts about the tested pages, the issues, and the violations retrievable at four levels of granularity.',
     'how to retrieve findings': {
-      'level 1': 'Use the listReports tool to get a list of available reports.',
+      'level 1': 'Use the listPages tool to get a list of tested pages, each with its latest report. The listIssues output about any report lists all reports about the same page.',
       'level 2': 'Use the listIssues tool to get a list of issues in one report.',
       'level 3': 'Use the listViolators tool to get a list of elements on one page that were reported in one report as exhibiting one issue.',
       'level 4': 'Use the listDiagnoses tool to get a list of diagnoses of how one element on one page exhibited one issue in one report.',
@@ -62,7 +62,7 @@ export const getToolsFacts = () => ({
       'new testing': 'If no report is available yet about a page, use the requestNewTest tool to request that it be tested.',
       'retesting': 'If the listIssues tool shows that the latest report about a page is obsolete, because the page has been revised or for another reason, use the requestRetest tool to request that the page be retested.',
       'latency': 'Requests for testing and retesting are usually approved and fulfilled within one day.',
-      'confirmation': 'Use the listReports tool to determine whether a requested new report exists. There is currently no process for notification of the outcome of requests.'
+      'confirmation': 'Use the listPages tool to determine whether a requested new report exists. There is currently no process for notification of the outcome of requests.'
     }
   },
   'URL': `${getThisHost()}/mcp`,
@@ -131,49 +131,30 @@ export const getRuleEnginesFacts = (ruleEngineIDSet: Iterable<string>) => {
   objectSort(ruleEnginesFacts, 'name', 'alpha');
   return ruleEnginesFacts;
 };
-// Returns the basics about a report.
-// Accepts an optional precomputed extract to avoid redundant reads when called
-// in a loop over all reports (e.g. by listReports). When the extract comes from
-// getReportExtracts, it carries a superseded flag; otherwise the flag is computed.
-// With an extract provided, failure is impossible, so the return type narrows
-// to ReportBasics; without one, an error object may be returned.
-// XXX Why are these overloads necessary? Can't we just have one function?
-export function getReportBasics(
-  timeStamp: string, jobID: string, extract: ReportExtract
-): Promise<ReportBasics>;
-export function getReportBasics(
-  timeStamp: string, jobID: string, extract?: ReportExtract | null
-): Promise<ReportBasics | {error: string}>;
-export async function getReportBasics(
-  timeStamp: string, jobID: string, extract: ReportExtract | null = null
-): Promise<ReportBasics | {error: string}> {
-  const extractProvided = !!extract;
-  // If an extract was not provided, verify the report exists and read it.
-  if (!extract) {
-    // Get the creation time of the report.
-    const reportStats = await getReportStats(timeStamp, jobID);
-    // If the  report does not exist:
-    if (!reportStats) {
-      // Log and return this.
-      console.error(`Report ${timeStamp}-${jobID} does not exist.`);
-      return {
-        error: `Report ${timeStamp}-${jobID} could not be retrieved.`
-      };
-    }
-    // Otherwise, i.e. if it exists, get an extract of the report.
-    const fetchedExtract = await getReportExtract(timeStamp, jobID);
-    // If this failed, return why.
-    if ('error' in fetchedExtract) {
-      return fetchedExtract;
-    }
-    extract = fetchedExtract;
+// Returns the basics about a report, or an error object if the report cannot be read.
+export const getReportBasics = async (
+  timeStamp: string, jobID: string
+): Promise<ReportBasics | {error: string}> => {
+  // Verify that the report exists.
+  const reportStats = await getReportStats(timeStamp, jobID);
+  // If it does not exist:
+  if (!reportStats) {
+    // Log and return this.
+    console.error(`Report ${timeStamp}-${jobID} does not exist.`);
+    return {
+      error: `Report ${timeStamp}-${jobID} could not be retrieved.`
+    };
+  }
+  // Otherwise, i.e. if it exists, get an extract of the report.
+  const extract = await getReportExtract(timeStamp, jobID);
+  // If this failed, return why.
+  if ('error' in extract) {
+    return extract;
   }
   const {url, description, reportTime} = extract;
   // Get whether this report has been superseded.
-  const isSuperseded = extractProvided
-    ? extract.superseded === true
-    : (await getReportExtracts(true))
-      .every(ex => ex.timeStamp !== timeStamp || ex.jobID !== jobID);
+  const isSuperseded = (await getReportExtracts(true))
+  .every(ex => ex.timeStamp !== timeStamp || ex.jobID !== jobID);
   // Get the basics about the report.
   const basics = {
     identifier: `${timeStamp}-${jobID}`,
@@ -187,7 +168,7 @@ export async function getReportBasics(
   };
   // Return them.
   return basics;
-}
+};
 // Returns the specification of an issue.
 export const getIssueSpec = (issueID: string) => {
   // Get the issue specification.

package/apiIntegration.test.ts

@@ -93,11 +93,11 @@ const request = (method: string, requestPath: string, body: any = null): Promise
 
 // TESTS
 
-test('GET /api/listReports returns valid JSON through the HTTP routing layer', {timeout: 500}, async () => {
-  const {body} = await request('GET', '/api/listReports');
-  assert.equal(body['tool name'], 'listReports');
-  const reports = body['response content']['basics about all available reports'];
-  assert.equal(reports.length, 8);
+test('GET /api/listPages returns valid JSON through the HTTP routing layer', {timeout: 500}, async () => {
+  const {body} = await request('GET', '/api/listPages');
+  assert.equal(body['tool name'], 'listPages');
+  const pages = body['response content']['basics about all tested pages'];
+  assert.equal(pages.length, 7);
 });
 
 test('POST /api/requestFeature parses a JSON body and returns a JSON response through the HTTP routing layer', async () => {

package/docs/AI-TOOLS.md

@@ -21,7 +21,7 @@ The internal features that make Kilotest a collection of tools for language mode
 
 - An API, with specific functional and utility modules in the `api` directory.
 - Tests of the functionalities of the API.
-- A [`JSON-LD`](https://json-ld.org/) script in the `index.html` file, providing structured data about the Kilotest API.
+- A [`JSON-LD`](https://json-ld.org/) script in the `web/home/index.html` file, providing structured data about the Kilotest API.
 - Environment variables in the `env.example` file.
 - An `llms.txt` file and an `llms-full.txt` file, documenting the use of Kilotest by language models, conforming to the [llms-txt](https://llmstxt.org/) specification.
 - A generated `openapi.yaml` file, documenting the Kilotest API, conforming to the [OpenAPI specification](https://spec.openapis.org/oas/v3.1.0).

package/docs/SERVICE.md

@@ -323,7 +323,19 @@ Both logs are rotated; see “PM2 log rotation” above for the application log
 
 ## Version management
 
-When a new version of the `kilotest` package has been published, the service can be updated as follows:
+When the Kilotest web, API, or MCP interface is revised in a feature branch:
+
+1. Update the version in `package.json`
+1. Update the version in `server.json`
+1. Update the version and any changes in the API in `lhm.plugin.json`
+1. If the API has changed, run the `generate:openapi` script
+1. Execute the command `npx @lobehub/market-cli plugin update --dir .`
+1. Commit and push the changes to the feature branch
+1. Create a pull request to merge the feature branch into `main`
+1. Once the checks succeed, squash and merge the branch into `main`
+1. Execute `npm publish`
+
+When a new version of the `kilotest` package has been published, update the service as follows:
 
 1. Connect to the server: `ssh linuxuser@kilotest.com`
 1. Navigate to the package root: `cd /opt/jpdev/kilotest`
@@ -331,7 +343,6 @@ When a new version of the `kilotest` package has been published, the service can
 1. Delete the record of that discard: `git stash drop`
 1. Fetch and merge the new version: `git pull`
 1. Update the dependencies: `npm update`
-1. Update the Playwright browsers: `npx playwright install`
 1. Restart the service: `pm2 restart kilotest`
 
 ## Branch protection
@@ -498,9 +509,9 @@ Kilotest records basic counts of how it is used, so the maintainer can answer qu
 
 `recordMetric(category, name)`, in `util.ts`, increments a count for a `(category, name)` pair and writes the result to `db/metrics.json`. It is called from three places:
 
-- The generic `.html` GET dispatch in `index.ts`, once per successfully served web page, recorded under the `pageViews` category by page name (for example `tutorialWeb`, `listReports`), unless the page is a manager-only page (see "Manager page activity" below), in which case it is recorded there instead.
+- The generic `.html` GET dispatch in `index.ts`, once per successfully served web page, recorded under the `pageViews` category by page name (for example `tutorialWeb`, `listPages`), unless the page is a manager-only page (see "Manager page activity" below), in which case it is recorded there instead.
 - The home page (`/` and `/index.html`), served by its own branch in `index.ts` rather than through the generic `.html` dispatch, recorded under `pageViews` as `index`.
-- Each of the 9 MCP tool handlers in `mcp.ts`, once per successful tool call, recorded under the `mcpToolCalls` category by tool name (for example `listReports`, `requestNewTest`).
+- Each of the 9 MCP tool handlers in `mcp.ts`, once per successful tool call, recorded under the `mcpToolCalls` category by tool name (for example `listPages`, `requestNewTest`).
 - The `/api/*` GET and POST service branches in `index.ts`, once per call, recorded under the `apiOperations` category by operation name.
 
 `db/metrics.json` also stores a `since` time stamp, set when the file is first created, so the counts can be read as "since this date" rather than assumed to cover Kilotest's entire history. `getMetrics()` backfills any category absent from an existing `db/metrics.json` (for example one written before a category such as `managerActivity` existed), so an older file remains readable rather than causing every subsequent request to error.
@@ -513,7 +524,7 @@ This exclusion exists because manager pages reflect the maintainer operating Kil
 
 #### Excluding the maintainer's own manual testing
 
-The manager-page exclusion above only keeps the maintainer's use of manager-only pages out of `pageViews`; it does not, by itself, keep the maintainer's manual testing of *ordinary* pages (for example clicking through `tutorialWeb.html` or `listReports.html` after a deployment) from being counted as real usage. A separate mechanism addresses that: submitting a valid `authCode` on `/metrics.html` sets a cookie (`kilotestExclude`), valid for 30 days, whose value is a SHA-256 hash of `AUTH_CODE` rather than the code itself, so the secret is never placed in a long-lived browser cookie. Every subsequent request from that browser that carries a matching cookie is excluded from `pageViews` and `apiOperations` (not from `managerActivity`, which should keep counting regardless, since it exists to surface suspected abuse, including from the maintainer's own browser if its cookie were ever compromised).
+The manager-page exclusion above only keeps the maintainer's use of manager-only pages out of `pageViews`; it does not, by itself, keep the maintainer's manual testing of *ordinary* pages (for example clicking through `tutorialWeb.html` or `listPages.html` after a deployment) from being counted as real usage. A separate mechanism addresses that: submitting a valid `authCode` on `/metrics.html` sets a cookie (`kilotestExclude`), valid for 30 days, whose value is a SHA-256 hash of `AUTH_CODE` rather than the code itself, so the secret is never placed in a long-lived browser cookie. Every subsequent request from that browser that carries a matching cookie is excluded from `pageViews` and `apiOperations` (not from `managerActivity`, which should keep counting regardless, since it exists to surface suspected abuse, including from the maintainer's own browser if its cookie were ever compromised).
 
 A fixed or guessable cookie value was deliberately avoided: Kilotest's source is public, so anyone could otherwise read it and set the same cookie in their own browser to exclude themselves from metrics at no cost, defeating the feature. Hashing `AUTH_CODE` means only someone who has already proven they know the real code can derive the correct cookie value.
 

package/index.test.ts

@@ -198,7 +198,7 @@ test('routes has GET and POST arrays', () => {
 // TESTS: smoke-test short-circuit
 
 test('GET with x-kilotest-smoke header returns a perfunctory 200', async () => {
-  const res = await request('GET', '/api/listReports', null, {'x-kilotest-smoke': '1'});
+  const res = await request('GET', '/api/listPages', null, {'x-kilotest-smoke': '1'});
   assert.equal(res.statusCode, 200);
   assert.equal(res.body, '{}');
 });
@@ -210,7 +210,7 @@ test('POST with x-kilotest-smoke header returns a perfunctory 200', async () =>
 });
 
 test('GET without x-kilotest-smoke header executes the handler', async () => {
-  const res = await request('GET', '/api/listReports');
+  const res = await request('GET', '/api/listPages');
   assert.equal(res.statusCode, 200);
   assert.notEqual(res.body, '{}');
 });
@@ -332,13 +332,13 @@ test('GET /favicon.ico serves the favicon as an icon', async () => {
   assert.ok(res.headers['content-type'].includes('image/x-icon'));
 });
 
-test('GET /api/listReports returns JSON with report data and records an API-operation metric', async () => {
-  const countBefore = await getMetricCount('apiOperations', 'listReports');
-  const res = await request('GET', '/api/listReports');
+test('GET /api/listPages returns JSON with report data and records an API-operation metric', async () => {
+  const countBefore = await getMetricCount('apiOperations', 'listPages');
+  const res = await request('GET', '/api/listPages');
   assert.equal(res.statusCode, 200);
   const body = jsonBody(res);
-  assert.equal(body['tool name'], 'listReports');
-  assert.equal(await getMetricCount('apiOperations', 'listReports'), countBefore + 1);
+  assert.equal(body['tool name'], 'listPages');
+  assert.equal(await getMetricCount('apiOperations', 'listPages'), countBefore + 1);
 });
 
 test('GET /api/listIssues/260101T0000/mix returns JSON with issue data', async () => {
@@ -471,7 +471,7 @@ test('POST /requestNewTest.html with valid data returns an HTML page', async ()
 
 test('POST /requestNewTest.html with an already-tested URL returns an error', async () => {
   const res = await formRequest('POST', '/requestNewTest.html', {
-    description: 'Mixed Outcomes Page',
+    description: 'Mixed Outcomes',
     url: 'https://example.com/mixed',
     why: 'Because accessibility matters'
   });
@@ -688,14 +688,14 @@ test('PUT / returns an invalid method error', async () => {
 
 // TESTS: requestHandler catch boundary
 
-test('GET /listReports.html returns a 500 error when an unexpected internal error occurs', {timeout: 500}, async () => {
+test('GET /listPages.html returns a 500 error when an unexpected internal error occurs', {timeout: 500}, async () => {
   // Corrupt testRequests.json so that getTestRequests throws, an error that should never occur in normal
   // operation and so is not handled by handleRequest itself, only by requestHandler's
   // outer catch boundary.
   const backup = await fs.readFile(testRequestsPath, 'utf8');
   await fs.writeFile(testRequestsPath, 'not valid json');
   try {
-    const res = await request('GET', '/listReports.html');
+    const res = await request('GET', '/listPages.html');
     assert.equal(res.statusCode, 500);
     assert.ok(res.headers['content-type'].includes('application/json'));
     const body = jsonBody(res);
@@ -932,10 +932,22 @@ test('GET /rules.html/<segment> redirects to the equivalent /listRules.html/<seg
   assert.equal(res.headers['location'], '/listRules.html/allCaps');
 });
 
-test('GET /targets.html redirects to /listReports.html', async () => {
+test('GET /targets.html redirects to /listPages.html', async () => {
   const res = await request('GET', '/targets.html', {}, {followRedirects: false});
   assert.equal(res.statusCode, 301);
-  assert.equal(res.headers['location'], '/listReports.html');
+  assert.equal(res.headers['location'], '/listPages.html');
+});
+
+test('GET /listReports.html redirects to /listPages.html', async () => {
+  const res = await request('GET', '/listReports.html', {}, {followRedirects: false});
+  assert.equal(res.statusCode, 301);
+  assert.equal(res.headers['location'], '/listPages.html');
+});
+
+test('GET /api/listReports redirects to /api/listPages', async () => {
+  const res = await request('GET', '/api/listReports', {}, {followRedirects: false});
+  assert.equal(res.statusCode, 301);
+  assert.equal(res.headers['location'], '/api/listPages');
 });
 
 test('GET /requestTest.html redirects to /requestNewTest.html', async () => {
@@ -1463,7 +1475,7 @@ test('GET /requestRetest.html/260202T0000/new is rejected as an invalid GET requ
 // tested by the unit tests in web/*/*.test.cjs.
 
 const htmlPagePaths = [
-  '/listReports.html',
+  '/listPages.html',
   '/listViolators.html/linkNoText/260101T0000/mix',
   '/listDiagnoses.html/linkNoText/260101T0000/mix/0',
   '/enqueueForm.html',
@@ -1520,11 +1532,11 @@ test('a request carrying the metrics-exclusion cookie does not record a pageView
   const {getExclusionCookieValue} = await import('./util.ts');
   const cookieHeader = `kilotestExclude=${getExclusionCookieValue()}`;
   const pageViewCountBefore = await getMetricCount('pageViews', 'tutorialWeb');
-  const apiOperationCountBefore = await getMetricCount('apiOperations', 'listReports');
+  const apiOperationCountBefore = await getMetricCount('apiOperations', 'listPages');
   await request('GET', '/tutorialWeb.html', null, {cookie: cookieHeader});
-  await request('GET', '/api/listReports', null, {cookie: cookieHeader});
+  await request('GET', '/api/listPages', null, {cookie: cookieHeader});
   assert.equal(await getMetricCount('pageViews', 'tutorialWeb'), pageViewCountBefore);
-  assert.equal(await getMetricCount('apiOperations', 'listReports'), apiOperationCountBefore);
+  assert.equal(await getMetricCount('apiOperations', 'listPages'), apiOperationCountBefore);
 });
 
 test('a request carrying an invalid exclusion cookie still records metrics normally', async () => {
@@ -1945,7 +1957,7 @@ test('a request logs a single-line JSON record with the expected fields', async
   const originalLog = console.log;
   console.log = (line: string) => logged.push(line);
   try {
-    await request('GET', '/listReports.html');
+    await request('GET', '/listPages.html');
   }
   finally {
     console.log = originalLog;
@@ -1961,7 +1973,7 @@ test('a request logs a single-line JSON record with the expected fields', async
   assert.equal(requestLines.length, 1);
   const record = JSON.parse(requestLines[0]!);
   assert.equal(record.method, 'GET');
-  assert.equal(record.path, '/listReports.html');
+  assert.equal(record.path, '/listPages.html');
   assert.equal(record.status, 200);
   assert.ok(record.ip);
   assert.ok(record.userAgent);
@@ -1991,7 +2003,7 @@ test('a smoke-test-flagged request is not logged as a general request', async ()
   const originalLog = console.log;
   console.log = (line: string) => logged.push(line);
   try {
-    await request('GET', '/listReports.html', null, {'x-kilotest-smoke': '1'});
+    await request('GET', '/listPages.html', null, {'x-kilotest-smoke': '1'});
   }
   finally {
     console.log = originalLog;

package/index.ts

@@ -40,6 +40,7 @@ import {handleMCP, mcpPath} from './mcp.ts';
 import fs from 'node:fs/promises';
 import {handleComment as handleTutorialWebComment} from './web/tutorialWeb/index.ts';
 import {answer as tutorialWeb} from './web/tutorialWeb/index.ts';
+import {answer as home} from './web/home/index.ts';
 import {answer as privacy} from './web/privacy/index.ts';
 import {answer as tutorialAI, handleComment as handleTutorialAIComment} from './web/tutorialAI/index.ts';
 import http, {type IncomingMessage, type ServerResponse} from 'node:http';
@@ -54,7 +55,7 @@ import {answer as expungeReportsForm} from './web/expungeReportsForm/index.ts';
 import {answer as hideReportForm} from './web/hideReportForm/index.ts';
 import {answer as listDiagnosesPage} from './web/listDiagnoses/index.ts';
 import {answer as listIssuesPage} from './web/listIssues/index.ts';
-import {answer as listReportsPage} from './web/listReports/index.ts';
+import {answer as listPagesPage} from './web/listPages/index.ts';
 import {answer as listRules} from './web/listRules/index.ts';
 import {answer as listTopIssues} from './web/listTopIssues/index.ts';
 import {answer as listViolatorsPage} from './web/listViolators/index.ts';
@@ -75,7 +76,7 @@ import {answer as unhideReportForm} from './web/unhideReportForm/index.ts';
 import {response as getReportAPI} from './api/getReport.ts';
 import {response as listDiagnosesAPI} from './api/listDiagnoses.ts';
 import {response as listIssuesAPI} from './api/listIssues.ts';
-import {response as listReportsAPI} from './api/listReports.ts';
+import {response as listPagesAPI} from './api/listPages.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';
@@ -112,7 +113,7 @@ const answer: {
   hideReportForm: PageHandler;
   listDiagnoses: PageHandler;
   listIssues: PageHandler;
-  listReports: PageHandler;
+  listPages: PageHandler;
   listRules: PageHandler;
   listTopIssues: PageHandler;
   listViolators: PageHandler;
@@ -143,7 +144,7 @@ const answer: {
   hideReportForm,
   listDiagnoses: listDiagnosesPage,
   listIssues: listIssuesPage,
-  listReports: listReportsPage,
+  listPages: listPagesPage,
   listRules,
   listTopIssues,
   listViolators: listViolatorsPage,
@@ -171,7 +172,7 @@ const apiRespond: {
   getReport: ApiResponder;
   listDiagnoses: ApiResponder;
   listIssues: ApiResponder;
-  listReports: ApiResponder;
+  listPages: ApiResponder;
   listViolators: ApiResponder;
   requestFeature: ApiResponder;
   requestRetest: ApiResponder;
@@ -183,7 +184,7 @@ const apiRespond: {
   getReport: getReportAPI,
   listDiagnoses: listDiagnosesAPI,
   listIssues: listIssuesAPI,
-  listReports: listReportsAPI,
+  listPages: listPagesAPI,
   listViolators: listViolatorsAPI,
   requestFeature: requestFeatureAPI,
   requestRetest: requestRetestAPI,
@@ -291,12 +292,16 @@ const noDirectGetPages = new Set(['unhideReportForm']);
 // 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.
+// listReports was renamed to listPages on 2026-10-09, since it lists tested pages, each
+// linked to its latest report.
+// TEMPORARY: retire this redirect after 2027-04-09 once crawlers have re-indexed.
 const renamedPagePrefixes: Record<string, string> = {
   diagnoses: 'listDiagnoses',
   reportIssue: 'listViolators',
   reportIssues: 'listIssues',
   rules: 'listRules',
-  targets: 'listReports',
+  targets: 'listPages',
+  listReports: 'listPages',
   requestTest: 'requestNewTest',
   requestTestForm: 'requestNewTestForm'
 };
@@ -638,10 +643,10 @@ const handleRequest = async (request: IncomingMessage, response: ServerResponse)
     else if (['/', '/index.html'].includes(pathname)) {
       await recordPageMetric('pageViews', 'index');
       // Get the home page.
-      const homePage = await fs.readFile('index.html', 'utf8');
+      const {answerPage} = await home();
       // Serve it.
       setHeaders('text/html', '/index.html', 'medium');
-      response.end(homePage);
+      response.end(answerPage);
     }
     // Otherwise, if it is for the crawler specification:
     else if (pageName === 'robots.txt') {
@@ -800,15 +805,22 @@ const handleRequest = async (request: IncomingMessage, response: ServerResponse)
     // Otherwise, if it is for an API service:
     else if (pageName === 'api') {
       const [service, ...specs] = pathTail.split('/');
-      // If the service lists the available reports:
-      if (service === 'listReports') {
+      // If the service lists the tested pages:
+      if (service === 'listPages') {
         // Get the response body.
-        const responseBody = await apiRespond.listReports([]);
-        await recordPageMetric('apiOperations', 'listReports');
+        const responseBody = await apiRespond.listPages([]);
+        await recordPageMetric('apiOperations', 'listPages');
         // Send it.
         setHeaders('application/json', null, 'ultra');
         response.end(JSON.stringify(responseBody));
       }
+      // Otherwise, if the service has the name that listPages had before 2026-10-09:
+      // TEMPORARY: retire this redirect after 2027-04-09.
+      else if (service === 'listReports') {
+        // Redirect the request to listPages.
+        response.writeHead(301, {Location: '/api/listPages'});
+        response.end();
+      }
       // Otherwise, if the service lists the issues in a report:
       else if (service === 'listIssues') {
         // Get the response body.