@jrpool/kilotest 59.1.3 → 60.0.0

package/lhm.plugin.json

@@ -125,7 +125,7 @@
                       "properties": {
                         "identifier": {
                           "type": "string",
-                          "description": "timeStamp-jobID identifier of the report."
+                          "description": "Identifier of the report (example: 260503T0432-x9z)."
                         },
                         "completion date and time": {
                           "type": "string"
@@ -419,18 +419,13 @@
       "inputSchema": {
         "type": "object",
         "properties": {
-          "timeStamp": {
+          "reportID": {
             "type": "string",
-            "description": "Timestamp of the report in YYMMDDTHHmm format (example: 260503T0432)"
-          },
-          "jobID": {
-            "type": "string",
-            "description": "Job identifier of the report (example: x9z)"
+            "description": "Identifier of the report (example: 260503T0432-x9z)"
           }
         },
         "required": [
-          "timeStamp",
-          "jobID"
+          "reportID"
         ],
         "$schema": "http://json-schema.org/draft-07/schema#"
       },
@@ -496,7 +491,7 @@
                       "properties": {
                         "identifier": {
                           "type": "string",
-                          "description": "timeStamp-jobID identifier of the report."
+                          "description": "Identifier of the report (example: 260503T0432-x9z)."
                         },
                         "completion date and time": {
                           "type": "string"
@@ -1073,7 +1068,7 @@
             "properties": {
               "identifier": {
                 "type": "string",
-                "description": "timeStamp-jobID identifier of the report."
+                "description": "Identifier of the report (example: 260503T0432-x9z)."
               },
               "completion date and time": {
                 "type": "string"
@@ -1162,19 +1157,14 @@
             "type": "string",
             "description": "Issue identifier (example: contrastPoor)"
           },
-          "timeStamp": {
-            "type": "string",
-            "description": "Timestamp of the report in YYMMDDTHHmm format (example: 260503T0432)"
-          },
-          "jobID": {
+          "reportID": {
             "type": "string",
-            "description": "Job identifier of the report (example: x9z)"
+            "description": "Identifier of the report (example: 260503T0432-x9z)"
           }
         },
         "required": [
           "issueID",
-          "timeStamp",
-          "jobID"
+          "reportID"
         ],
         "$schema": "http://json-schema.org/draft-07/schema#"
       },
@@ -1512,7 +1502,7 @@
             "properties": {
               "identifier": {
                 "type": "string",
-                "description": "timeStamp-jobID identifier of the report."
+                "description": "Identifier of the report (example: 260503T0432-x9z)."
               },
               "completion date and time": {
                 "type": "string"
@@ -1672,20 +1662,15 @@
             "type": "string",
             "description": "Issue identifier (example: contrastPoor)"
           },
-          "timeStamp": {
+          "reportID": {
             "type": "string",
-            "description": "Timestamp of the report in YYMMDDTHHmm format (example: 260503T0432)"
-          },
-          "jobID": {
-            "type": "string",
-            "description": "Job identifier of the report (example: x9z)"
+            "description": "Identifier of the report (example: 260503T0432-x9z)"
           }
         },
         "required": [
           "catalogIndex",
           "issueID",
-          "timeStamp",
-          "jobID"
+          "reportID"
         ],
         "$schema": "http://json-schema.org/draft-07/schema#"
       },
@@ -2062,7 +2047,7 @@
             "properties": {
               "identifier": {
                 "type": "string",
-                "description": "timeStamp-jobID identifier of the report."
+                "description": "Identifier of the report (example: 260503T0432-x9z)."
               },
               "completion date and time": {
                 "type": "string"
@@ -2188,18 +2173,13 @@
       "inputSchema": {
         "type": "object",
         "properties": {
-          "timeStamp": {
+          "reportID": {
             "type": "string",
-            "description": "Timestamp of the report in YYMMDDTHHmm format (example: 260503T0432)"
-          },
-          "jobID": {
-            "type": "string",
-            "description": "Job identifier of the report (example: x9z)"
+            "description": "Identifier of the report (example: 260503T0432-x9z)"
           }
         },
         "required": [
-          "timeStamp",
-          "jobID"
+          "reportID"
         ],
         "$schema": "http://json-schema.org/draft-07/schema#"
       },
@@ -2810,13 +2790,9 @@
       "inputSchema": {
         "type": "object",
         "properties": {
-          "timeStamp": {
-            "type": "string",
-            "description": "Timestamp of the latest report about the page in YYMMDDTHHmm format (example: 260503T0432)"
-          },
-          "jobID": {
+          "reportID": {
             "type": "string",
-            "description": "Job identifier of the latest report about the page (example: x9z)"
+            "description": "Identifier of the latest report about the page (example: 260503T0432-x9z)"
           },
           "reason": {
             "type": "string",
@@ -2824,8 +2800,7 @@
           }
         },
         "required": [
-          "timeStamp",
-          "jobID",
+          "reportID",
           "reason"
         ],
         "$schema": "http://json-schema.org/draft-07/schema#"
@@ -3603,7 +3578,8 @@
                       "report identifier": {
                         "anyOf": [
                           {
-                            "$ref": "#/definitions/ReportIdentifier"
+                            "type": "string",
+                            "description": "Identifier of the report, to pass to listIssues once the report is ready (example: 260503T0432-x9z)."
                           },
                           {
                             "type": "null"
@@ -3779,24 +3755,6 @@
               "date and time"
             ],
             "additionalProperties": false
-          },
-          "ReportIdentifier": {
-            "type": "object",
-            "properties": {
-              "timeStamp": {
-                "type": "string",
-                "description": "Timestamp to pass to listIssues once the report is ready."
-              },
-              "jobID": {
-                "type": "string",
-                "description": "Job identifier to pass to listIssues once the report is ready."
-              }
-            },
-            "required": [
-              "timeStamp",
-              "jobID"
-            ],
-            "additionalProperties": false
           }
         }
       },
@@ -3817,13 +3775,9 @@
       "inputSchema": {
         "type": "object",
         "properties": {
-          "timeStamp": {
+          "reportID": {
             "type": "string",
-            "description": "Timestamp of the latest report about the page in YYMMDDTHHmm format (example: 260503T0432)"
-          },
-          "jobID": {
-            "type": "string",
-            "description": "Job identifier of the latest report about the page (example: x9z)"
+            "description": "Identifier of the latest report about the page (example: 260503T0432-x9z)"
           },
           "reason": {
             "type": "string",
@@ -3831,8 +3785,7 @@
           }
         },
         "required": [
-          "timeStamp",
-          "jobID",
+          "reportID",
           "reason"
         ],
         "$schema": "http://json-schema.org/draft-07/schema#"
@@ -3977,7 +3930,8 @@
                       "report identifier": {
                         "anyOf": [
                           {
-                            "$ref": "#/definitions/ReportIdentifier"
+                            "type": "string",
+                            "description": "Identifier of the report, to pass to listIssues once the report is ready (example: 260503T0432-x9z)."
                           },
                           {
                             "type": "null"
@@ -4153,24 +4107,6 @@
               "date and time"
             ],
             "additionalProperties": false
-          },
-          "ReportIdentifier": {
-            "type": "object",
-            "properties": {
-              "timeStamp": {
-                "type": "string",
-                "description": "Timestamp to pass to listIssues once the report is ready."
-              },
-              "jobID": {
-                "type": "string",
-                "description": "Job identifier to pass to listIssues once the report is ready."
-              }
-            },
-            "required": [
-              "timeStamp",
-              "jobID"
-            ],
-            "additionalProperties": false
           }
         }
       },
@@ -4191,18 +4127,13 @@
       "inputSchema": {
         "type": "object",
         "properties": {
-          "timeStamp": {
-            "type": "string",
-            "description": "Timestamp of the ordered job, from the report identifier returned by orderNewTest, in YYMMDDTHHmm format (example: 260503T0432)"
-          },
-          "jobID": {
+          "reportID": {
             "type": "string",
-            "description": "Job identifier of the ordered job, from the report identifier returned by orderNewTest (example: x9z)"
+            "description": "Report identifier returned by orderNewTest or orderRetest (example: 260503T0432-x9z)"
           }
         },
         "required": [
-          "timeStamp",
-          "jobID"
+          "reportID"
         ],
         "$schema": "http://json-schema.org/draft-07/schema#"
       },
@@ -4285,7 +4216,8 @@
                     "type": "object",
                     "properties": {
                       "report identifier": {
-                        "$ref": "#/definitions/ReportIdentifier"
+                        "type": "string",
+                        "description": "Identifier of the report, to pass to listIssues once the report is ready (example: 260503T0432-x9z)."
                       }
                     },
                     "required": [
@@ -4476,24 +4408,6 @@
               "date and time"
             ],
             "additionalProperties": false
-          },
-          "ReportIdentifier": {
-            "type": "object",
-            "properties": {
-              "timeStamp": {
-                "type": "string",
-                "description": "Timestamp to pass to listIssues once the report is ready."
-              },
-              "jobID": {
-                "type": "string",
-                "description": "Job identifier to pass to listIssues once the report is ready."
-              }
-            },
-            "required": [
-              "timeStamp",
-              "jobID"
-            ],
-            "additionalProperties": false
           }
         }
       },
@@ -4509,5 +4423,5 @@
       }
     }
   ],
-  "version": "59.1.3"
+  "version": "59.1.4"
 }

package/llms-full.txt

@@ -56,11 +56,11 @@ Kilotest offers a comprehensive suite of capabilities to users via its web UI:
 
 - [Home page](https://kilotest.com/)
 - [Get a list of all tested pages, each linked to its latest report](https://kilotest.com/listPages.html)
-- Get statistics about issues reported in one report, and a history of all reports about the same page: `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}`
+- Get statistics about issues reported in one report, and a history of all reports about the same page: `https://kilotest.com/listIssues.html/{reportID}`
+- Get details about one issue reported in one report: `https://kilotest.com/listViolators.html/{issueID}/{reportID}`
+- Get diagnoses by rule engines of rule violations for one HTML element exhibiting one issue in one report: `https://kilotest.com/listDiagnoses.html/{issueID}/{reportID}/{catalogIndex}`
 - [Request the testing of a not-yet-tested page](https://kilotest.com/requestNewTestForm.html)
-- Request the retesting of a previously tested page: `https://kilotest.com/requestRetestForm.html/{timeStamp}/{jobID}`
+- Request the retesting of a previously tested page: `https://kilotest.com/requestRetestForm.html/{reportID}`
 - [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/tutorialWeb.html)
@@ -80,29 +80,26 @@ Kilotest offers these tools:
 - `listIssues`
   - method: `GET`
   - purpose: list all issues in one report, and all reports about the same page, from oldest to latest
-  - path: `/api/listIssues/{timeStamp}/{jobID}`
+  - path: `/api/listIssues/{reportID}`
   - parameters
-    - `timeStamp`: initial segment of report identifier
-    - `jobID`: final segment of report identifier
+    - `reportID`: identifier of the report, with YYMMDDTHHmm format for its initial segment (example: 260503T0432-x9z)
   - source of parameters: response to a `listPages` request, or the history of reports about the page in the response to a `listIssues` request
 - `listViolators`
   - method: `GET`
   - purpose: list all elements exhibiting one issue in one report
-  - path: `/api/listViolators/{issueID}/{timeStamp}/{jobID}`
+  - path: `/api/listViolators/{issueID}/{reportID}`
   - parameters
     - `issueID`: identifier of the issue
-    - `timeStamp`: initial segment of report identifier
-    - `jobID`: final segment of report identifier
+    - `reportID`: identifier of the report, with YYMMDDTHHmm format for its initial segment (example: 260503T0432-x9z)
   - source of parameters: response to a `listIssues` request
 - `listDiagnoses`
   - method: `GET`
   - purpose: list all diagnoses of one issue exhibited by one element in one report
-  - path: `/api/listDiagnoses/{catalogIndex}/{issueID}/{timeStamp}/{jobID}`
+  - path: `/api/listDiagnoses/{catalogIndex}/{issueID}/{reportID}`
   - parameters
     - `catalogIndex`: index of the catalog entry of the element
     - `issueID`: identifier of the issue
-    - `timeStamp`: initial segment of report identifier
-    - `jobID`: final segment of report identifier
+    - `reportID`: identifier of the report, with YYMMDDTHHmm format for its initial segment (example: 260503T0432-x9z)
   - source of parameters: response to a `listViolators` request
 - `requestNewTest`
   - method: `POST`
@@ -115,10 +112,9 @@ Kilotest offers these tools:
 - `requestRetest`
   - method: `POST`
   - purpose: request retesting of one web page about which a report is available
-  - path: `/api/requestRetest/{timeStamp}/{jobID}`
+  - path: `/api/requestRetest/{reportID}`
   - parameters
-    - `timeStamp`: initial segment of report identifier
-    - `jobID`: final segment of report identifier
+    - `reportID`: identifier of the report, with YYMMDDTHHmm format for its initial segment (example: 260503T0432-x9z)
   - source of parameters: response to a `listIssues` request
   - payload properties
     - `reason`: reason for retesting the page
@@ -136,25 +132,23 @@ Kilotest offers these tools:
     - `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
+  - response includes a report identifier (`reportID`) 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}`
+  - path: `/api/orderRetest/{reportID}`
   - parameters
-    - `timeStamp`: initial segment of report identifier
-    - `jobID`: final segment of report identifier
+    - `reportID`: identifier of the report, with YYMMDDTHHmm format for its initial segment (example: 260503T0432-x9z)
   - 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
+  - response includes a report identifier (`reportID`) 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}`
+  - path: `/api/awaitTest/{reportID}`
   - 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`
+    - `reportID`: the report identifier returned by `orderNewTest` or `orderRetest` (example: 260503T0432-x9z)
   - source of parameters: response to an `orderNewTest` or `orderRetest` request
   - caveat: testing typically takes 2 to 4 minutes; sends no interim notices while waiting
 

package/llms.txt

@@ -5,16 +5,16 @@ Kilotest integrates an ensemble of 12 rule engines, with about 1,300 rules, to t
 ## API
 
 - [List all tested pages, each with its latest report](/api/listPages) (`GET`)
-- List all issues in one report, and all reports about the same page: `/api/listIssues/{timeStamp}/{jobID}` (`GET`)
-- 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`)
+- List all issues in one report, and all reports about the same page: `/api/listIssues/{reportID}` (`GET`)
+- List all elements exhibiting one issue in one report: `/api/listViolators/{issueID}/{reportID}` (`GET`)
+- List all diagnoses of one element exhibiting one issue in one report: `/api/listDiagnoses/{catalogIndex}/{issueID}/{reportID}` (`GET`)
+- Get one full report in JSON: `/api/getReport/{reportID}` (`GET`)
 - Request testing of a web page: `/api/requestNewTest` (`POST`)
-- Request retesting of a web page: `/api/requestRetest/{timeStamp}/{jobID}` (`POST`)
+- Request retesting of a web page: `/api/requestRetest/{reportID}` (`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`)
+- Order immediate, automatically approved retesting of a web page: `/api/orderRetest/{reportID}` (`POST`)
+- Wait for a job ordered via orderNewTest or orderRetest to complete: `/api/awaitTest/{reportID}` (`POST`)
 
 ## MCP Server
 
@@ -23,12 +23,12 @@ Kilotest integrates an ensemble of 12 rule engines, with about 1,300 rules, to t
 ## Web UI
 
 - [List all tested pages, each linked to its latest report](https://kilotest.com/listPages.html)
-- List all issues in one report, and all reports about the same page: `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}`
+- List all issues in one report, and all reports about the same page: `https://kilotest.com/listIssues.html/{reportID}`
+- List all elements exhibiting one issue in one report: `https://kilotest.com/listViolators.html/{issueID}/{reportID}`
+- List all diagnoses of one element exhibiting one issue in one report: `https://kilotest.com/listDiagnoses.html/{issueID}/{reportID}/{catalogIndex}`
+- Get one full report in JSON: `https://kilotest.com/fullReport.json/{reportID}`
 - [Request testing of a web page](https://kilotest.com/requestNewTestForm.html)
-- Request retesting of a web page: `https://kilotest.com/requestRetestForm.html/{timeStamp}/{jobID}`
+- Request retesting of a web page: `https://kilotest.com/requestRetestForm.html/{reportID}`
 - [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)
 - [Tutorial, “Accessibility testing strategies”](https://kilotest.com/tutorial.html)

package/mcp.test.ts

@@ -111,8 +111,7 @@ test('listIssues handler returns content and structuredContent for a valid repor
   const server = createMCPServer();
   const countBefore = getToolCallCount('listIssues');
   const result = await (server as any)._registeredTools.listIssues.handler({
-    timeStamp: '260101T0000',
-    jobID: 'mix'
+    reportID: '260101T0000-mix'
   });
   assert.ok(result.content);
   assert.equal(result.content[0].type, 'text');
@@ -125,8 +124,7 @@ test('listViolators handler returns content and structuredContent for a valid is
   const countBefore = getToolCallCount('listViolators');
   const result = await (server as any)._registeredTools.listViolators.handler({
     issueID: 'linkNoText',
-    timeStamp: '260101T0000',
-    jobID: 'mix'
+    reportID: '260101T0000-mix'
   });
   assert.ok(result.content);
   assert.equal(result.content[0].type, 'text');
@@ -140,8 +138,7 @@ test('listDiagnoses handler returns content and structuredContent for a valid di
   const result = await (server as any)._registeredTools.listDiagnoses.handler({
     catalogIndex: '0',
     issueID: 'linkNoText',
-    timeStamp: '260101T0000',
-    jobID: 'mix'
+    reportID: '260101T0000-mix'
   });
   assert.ok(result.content);
   assert.equal(result.content[0].type, 'text');
@@ -153,8 +150,7 @@ test('getReport handler returns content and structuredContent for a valid report
   const server = createMCPServer();
   const countBefore = getToolCallCount('getReport');
   const result = await (server as any)._registeredTools.getReport.handler({
-    timeStamp: '260101T0000',
-    jobID: 'mix'
+    reportID: '260101T0000-mix'
   });
   assert.ok(result.content);
   assert.equal(result.content[0].type, 'text');
@@ -180,8 +176,7 @@ test('requestRetest handler returns content and structuredContent for a valid re
   const server = createMCPServer();
   const countBefore = getToolCallCount('requestRetest');
   const result = await (server as any)._registeredTools.requestRetest.handler({
-    timeStamp: '260101T0000',
-    jobID: 'mix',
+    reportID: '260101T0000-mix',
     reason: 'Because the report is obsolete'
   });
   assert.ok(result.content);
@@ -217,7 +212,7 @@ test('orderNewTest handler returns content and structuredContent, and enqueues a
   assert.equal(getToolCallCount('orderNewTest'), countBefore + 1);
   const reportIdentifier = result.structuredContent['response content']['disposition of your order']['report identifier'];
   assert.ok(reportIdentifier);
-  const queuedPath = `${jobsPath()}/queue/${reportIdentifier.timeStamp}-${reportIdentifier.jobID}.json`;
+  const queuedPath = `${jobsPath()}/queue/${reportIdentifier}.json`;
   fs.unlinkSync(queuedPath);
 });
 
@@ -228,8 +223,7 @@ test('orderRetest handler returns content and structuredContent, and enqueues a
   // 260202T0000-new is the latest report of "Mixed Outcomes" (260101T0000-mix is an
   // earlier, superseded report of the same page), so this order is accepted.
   const result = await (server as any)._registeredTools.orderRetest.handler({
-    timeStamp: '260202T0000',
-    jobID: 'new',
+    reportID: '260202T0000-new',
     reason: 'Because the report is obsolete'
   });
   assert.ok(result.content);
@@ -238,7 +232,7 @@ test('orderRetest handler returns content and structuredContent, and enqueues a
   assert.equal(getToolCallCount('orderRetest'), countBefore + 1);
   const reportIdentifier = result.structuredContent['response content']['disposition of your order']['report identifier'];
   assert.ok(reportIdentifier);
-  const queuedPath = `${jobsPath()}/queue/${reportIdentifier.timeStamp}-${reportIdentifier.jobID}.json`;
+  const queuedPath = `${jobsPath()}/queue/${reportIdentifier}.json`;
   fs.unlinkSync(queuedPath);
 });
 
@@ -246,8 +240,7 @@ test('awaitTest handler returns content and structuredContent for an already-com
   const server = createMCPServer();
   const countBefore = getToolCallCount('awaitTest');
   const result = await (server as any)._registeredTools.awaitTest.handler({
-    timeStamp: '260101T0000',
-    jobID: 'mix'
+    reportID: '260101T0000-mix'
   });
   assert.ok(result.content);
   assert.equal(result.content[0].type, 'text');
@@ -259,8 +252,7 @@ test('awaitTest handler returns content and structuredContent for an already-com
 test('listIssues handler returns an error for a nonexistent report', async () => {
   const server = createMCPServer();
   const result = await (server as any)._registeredTools.listIssues.handler({
-    timeStamp: '990101T0000',
-    jobID: 'xxx'
+    reportID: '990101T0000-xxx'
   });
   const reportBasics = result.structuredContent['response content']['basics about the report'];
   assert.ok(reportBasics.error);
@@ -270,8 +262,7 @@ test('listViolators handler returns an error for an unknown issue', async () =>
   const server = createMCPServer();
   const result = await (server as any)._registeredTools.listViolators.handler({
     issueID: 'nonexistentIssue',
-    timeStamp: '260101T0000',
-    jobID: 'mix'
+    reportID: '260101T0000-mix'
   });
   const issueBasics = result.structuredContent['response content']['basics about the issue'];
   assert.ok(issueBasics.error);