@jrpool/kilotest 61.0.0 → 62.0.0

package/api/schemas.ts

@@ -73,6 +73,16 @@ export const awaitTestSchema = {
   reportID: z.string().describe('Report identifier returned by orderNewTest or orderRetest (example: 260503T0432-x9z)')
 };
 
+// reportDisagreement: POST /api/reportDisagreement/{issueID}/{reportID}/{catalogIndex}
+export const reportDisagreementSchema = {
+  issueID: z.string().describe('Issue identifier (example: contrastPoor)'),
+  reportID: z.string().describe('Identifier of the report (example: 260503T0432-x9z)'),
+  catalogIndex: z.string().describe('Identifier of the issue-exhibiting element in the catalog of elements on the page (example: 372)'),
+  engineID: z.string().describe('Identifier of the rule engine that produced the disputed diagnosis (example: axe), as shown in the listDiagnoses output'),
+  ruleID: z.string().describe('Identifier of the rule whose diagnosis is disputed, as shown in the listDiagnoses output (example: color-contrast); if that output shows null for the rule identifier, use its description of the violation instead'),
+  reason: z.string().describe('20- to 1000-character explanation of why the diagnosis is disputed')
+};
+
 // listPages takes no input; omitted (mcp.ts already uses inputSchema: {}).
 
 // RESPONSE SCHEMAS
@@ -278,7 +288,7 @@ export const listViolatorsResponseSchema = envelope('GET', z.object({
     'tag name': z.unknown().describe('Copied from the report catalog entry; type not guaranteed.'),
     'inner text': z.unknown().describe('Copied from the report catalog entry; type not guaranteed.'),
     'count of rule engines reporting that the element exhibited the issue': z.number(),
-    'how to get details about the element': z.object({URL: z.string(), 'request method': z.literal('GET')}),
+    'how to get details about the element': z.object({method: z.literal('GET'), URL: z.string()}),
     'web users can get details about the element at': z.string()
   })).nullable()
 }));
@@ -297,10 +307,20 @@ export const listDiagnosesResponseSchema = envelope('GET', z.object({
     'x, y, width, and height of bounding box': z.unknown().describe('Copied from the report catalog entry; type not guaranteed.')
   }).nullable(),
   'diagnoses of how the element exhibited the issue': z.array(z.object({
+    'identifier of the rule engine': z.unknown().describe('Copied from the report act (which); type not guaranteed.'),
     'identifier of the violated rule': z.unknown().describe('Copied from the report instance (ruleID); type not guaranteed.'),
     'description of the violation': z.unknown().describe('Copied from the report instance (what); type not guaranteed.'),
     'severity of the violation on a 0-to-3 scale': z.unknown().describe('Copied from the report instance (ordinalSeverity); type not guaranteed.'),
-    'count of violations of the rule by the element': z.number()
+    'count of violations of the rule by the element': z.number(),
+    'how to report that you disagree with this diagnosis': z.object({
+      method: z.literal('POST'),
+      URL: z.string(),
+      'request body': z.object({
+        engineID: z.string(),
+        ruleID: z.string(),
+        reason: z.string()
+      })
+    })
   })).or(z.object({error: z.string()})).nullable()
 }));
 
@@ -362,6 +382,28 @@ export const requestFeatureResponseSchema = envelope(
   z.null()
 );
 
+export const reportDisagreementResponseSchema = envelope(
+  'POST',
+  z.object({'details about your request': z.union([
+    z.object({error: z.string()}),
+    z.object({
+      'date and time received': z.string(),
+      'diagnosis you disagree with': z.object({
+        'issue identifier': z.string(),
+        'identifier of the rule engine': z.string(),
+        'identifier of the violated rule': z.string()
+      }),
+      disposition: z.string()
+    })
+  ])}),
+  z.object({
+    engineID: reportDisagreementSchema.engineID,
+    ruleID: reportDisagreementSchema.ruleID,
+    reason: reportDisagreementSchema.reason
+  }),
+  z.null()
+);
+
 // Identifies the report a successfully ordered or awaited job will produce, once complete.
 const reportIdentifierSchema = z.string().describe('Identifier of the report, to pass to listIssues once the report is ready (example: 260503T0432-x9z).');
 

package/apiIntegration.test.ts

@@ -16,11 +16,13 @@ import {requestHandler} from './index.ts';
 
 const port = 3998;
 const featureRequestsPath = path.join(import.meta.dirname, 'test/fixtures/apiIntegration/featureRequests.json');
+const disagreementsPath = path.join(import.meta.dirname, 'test/fixtures/apiIntegration/disagreements.json');
 
 // SETUP AND TEARDOWN
 
 const savedDBDir = process.env.DB_DIR;
 const savedFeatureRequestsPath = process.env.FEATURE_REQUESTS_PATH;
+const savedDisagreementsPath = process.env.DISAGREEMENTS_PATH;
 let server: http.Server;
 
 before(async () => {
@@ -31,6 +33,9 @@ before(async () => {
   process.env.FEATURE_REQUESTS_PATH = featureRequestsPath;
   await fs.mkdir(path.dirname(featureRequestsPath), {recursive: true});
   await fs.writeFile(featureRequestsPath, '[]\n');
+  // The same for diagnosis disagreements.
+  process.env.DISAGREEMENTS_PATH = disagreementsPath;
+  await fs.writeFile(disagreementsPath, '[]\n');
   server = http.createServer(requestHandler);
   await new Promise<void>(resolve => server.listen(port, () => resolve()));
 });
@@ -48,6 +53,12 @@ after(async () => {
   else {
     delete process.env.FEATURE_REQUESTS_PATH;
   }
+  if (savedDisagreementsPath !== undefined) {
+    process.env.DISAGREEMENTS_PATH = savedDisagreementsPath;
+  }
+  else {
+    delete process.env.DISAGREEMENTS_PATH;
+  }
   await fs.rm(path.dirname(featureRequestsPath), {recursive: true, force: true});
   server.closeAllConnections?.();
   await new Promise<void>(resolve => {
@@ -106,3 +117,14 @@ test('POST /api/requestFeature parses a JSON body and returns a JSON response th
   assert.equal(details.error, undefined);
   assert.equal(details.disposition, 'received and logged; manager notified');
 });
+
+test('POST /api/reportDisagreement parses path parameters and a JSON body and returns a JSON response through the HTTP routing layer', async () => {
+  const {body} = await request('POST', '/api/reportDisagreement/linkNoText/260101T0000-mix/0', {
+    engineID: 'axe',
+    ruleID: 'r11',
+    reason: 'The element does have an accessible name'
+  });
+  const details = body['response content']['details about your request'];
+  assert.equal(details.error, undefined);
+  assert.equal(details.disposition, 'received and logged; manager notified');
+});

package/docs/SERVICE.md

@@ -409,9 +409,11 @@ Alerts are sent to the maintainer in the following conditions:
 
 7. **MCP feature request received**: When a user submits a feature request via the MCP server's `requestFeature` tool, an alert is sent with subject `"MCP feature request received"`, including the text of the feature request, and the request is also appended to `db/featureRequests.json`, the same way tutorial comments are appended to their own files (see item 1), so that a manager can review or delete it later via `/deleteNotesForm.html`.
 
-8. **WAVE balance low**: When Kilotest detects that the account balance for the WAVE API service (used for accessibility testing) has fallen below a threshold, an alert is sent with subject `"Kilotest: WAVE balance low"`, indicating the number of credits remaining.
+8. **Diagnosis disagreement received**: When a user reports disagreement with a diagnosis via the API’s or MCP server’s `reportDisagreement` operation, an alert is sent with subject `"Kilotest: diagnosis disagreement received"`, including the reason, the disputed diagnosis (rule engine, rule, issue, element, and report), and the disagreement is also appended to `db/disagreements.json`, so that a manager can review it and, when warranted, propose a correction to the `testaro-issues` classification (see item 3 for how such corrections take effect).
 
-9. **AI service balance low**: When Kilotest detects that the account balance for an AI service account (such as Anthropic) has fallen below a threshold, an alert is sent with subject `"Kilotest: AI service [N] balance low"`, indicating the approximate remaining balance in dollars and the estimated cost per job.
+9. **WAVE balance low**: When Kilotest detects that the account balance for the WAVE API service (used for accessibility testing) has fallen below a threshold, an alert is sent with subject `"Kilotest: WAVE balance low"`, indicating the number of credits remaining.
+
+10. **AI service balance low**: When Kilotest detects that the account balance for an AI service account (such as Anthropic) has fallen below a threshold, an alert is sent with subject `"Kilotest: AI service [N] balance low"`, indicating the approximate remaining balance in dollars and the estimated cost per job.
 
 ### Alert configuration
 
@@ -427,7 +429,7 @@ If any of these five variables is missing or empty at alert time, the alert is n
 
 ### Inbox size limits
 
-Four submission types (test requests and retest requests together, web tutorial comments, AI tutorial comments, and MCP feature requests) are each held in a pending "inbox" (`db/jobs/testRequests.json`, `db/comments/tutorialWeb.json`, `db/comments/tutorialAI.json`, and `db/featureRequests.json` respectively) awaiting manual review by the maintainer. Each inbox has a maximum size; once reached, a new, distinct submission is rejected (with a message suggesting the requester instead post to the [GitHub issues page](https://github.com/jrpool/kilotest/issues) or email `info@kilotest.com`) rather than added, so neither the inbox file nor the manager alert emails it generates can grow without bound (see GitHub issue #3, abuse type 3, repeated/automated submissions). This is modeled on a full mailbox rejecting new mail, rather than on a submission rate limit: it is the backlog size itself, not how quickly it grows, that costs the maintainer review time and risks unbounded storage. Every alert sent for an accepted submission reports the resulting inbox count against its cap, so a maintainer returning after an absence can immediately see how close an inbox is to full.
+Five submission types (test requests and retest requests together, web tutorial comments, AI tutorial comments, MCP feature requests, and diagnosis disagreements) are each held in a pending "inbox" (`db/jobs/testRequests.json`, `db/comments/tutorialWeb.json`, `db/comments/tutorialAI.json`, `db/featureRequests.json`, and `db/disagreements.json` respectively) awaiting manual review by the maintainer. Each inbox has a maximum size; once reached, a new, distinct submission is rejected (with a message suggesting the requester instead post to the [GitHub issues page](https://github.com/jrpool/kilotest/issues) or email `info@kilotest.com`) rather than added, so neither the inbox file nor the manager alert emails it generates can grow without bound (see GitHub issue #3, abuse type 3, repeated/automated submissions). This is modeled on a full mailbox rejecting new mail, rather than on a submission rate limit: it is the backlog size itself, not how quickly it grows, that costs the maintainer review time and risks unbounded storage. Every alert sent for an accepted submission reports the resulting inbox count against its cap, so a maintainer returning after an absence can immediately see how close an inbox is to full.
 
 Each cap defaults to 20 and can be set independently via an environment variable:
 
@@ -435,6 +437,7 @@ Each cap defaults to 20 and can be set independently via an environment variable
 2. **`TUTORIAL_WEB_COMMENTS_MAX`**: The maximum number of comments held on the web tutorial page (`/tutorialWeb.html`).
 3. **`TUTORIAL_AI_COMMENTS_MAX`**: The maximum number of comments held on the AI agent tutorial page (`/tutorialAI.html`).
 4. **`FEATURE_REQUESTS_MAX`**: The maximum number of feature requests held via the MCP server's `requestFeature` tool.
+5. **`DISAGREEMENTS_MAX`**: The maximum number of disagreements with diagnoses held via the API’s or MCP server’s `reportDisagreement` operation.
 
 Each variable, if set, must be a non-negative integer; if unset, empty, or not a non-negative integer, the default of 20 is used instead. A value of `0` means no limit: that inbox is never treated as full, regardless of size. Unlike the alert-configuration variables above, these are not required: an unset value never disables the limit, it only selects the default size.
 

package/env.example

@@ -35,6 +35,8 @@ TUTORIAL_WEB_COMMENTS_PATH=__placeholder__
 TUTORIAL_AI_COMMENTS_PATH=__placeholder__
 # Path of the feature requests file (defaults to db/featureRequests.json).
 FEATURE_REQUESTS_PATH=__placeholder__
+# Path of the diagnosis disagreements file (defaults to db/disagreements.json).
+DISAGREEMENTS_PATH=__placeholder__
 
 # Inbox size limits: each defaults to 20 if unset, empty, or not a non-negative integer.
 # A value of 0 means no limit.
@@ -47,6 +49,9 @@ TUTORIAL_WEB_COMMENTS_MAX=__placeholder__
 TUTORIAL_AI_COMMENTS_MAX=__placeholder__
 # Maximum number of feature requests held via the MCP server's requestFeature tool.
 FEATURE_REQUESTS_MAX=__placeholder__
+# Maximum number of disagreements with diagnoses held via the MCP server's
+# reportDisagreement tool.
+DISAGREEMENTS_MAX=__placeholder__
 # Maximum number of jobs allowed in the job queue (db/jobs/queue) at once. Shared by every
 # path that enqueues a job: manager approval of a pending test/retest request, and the
 # orderNewTest/orderRetest MCP tools, which enqueue directly.

package/index.ts

@@ -88,6 +88,7 @@ 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';
+import {response as reportDisagreementAPI} from './api/reportDisagreement.ts';
 
 // ENVIRONMENT
 
@@ -190,6 +191,7 @@ const apiRespond: {
   orderNewTest: ApiResponder;
   orderRetest: ApiResponder;
   awaitTest: ApiResponder;
+  reportDisagreement: ApiResponder;
 } = {
   getReport: getReportAPI,
   listDiagnoses: listDiagnosesAPI,
@@ -201,7 +203,8 @@ const apiRespond: {
   requestNewTest: requestNewTestAPI,
   orderNewTest: orderNewTestAPI,
   orderRetest: orderRetestAPI,
-  awaitTest: awaitTestAPI
+  awaitTest: awaitTestAPI,
+  reportDisagreement: reportDisagreementAPI
 };
 
 // CONSTANTS
@@ -1396,6 +1399,16 @@ const handleRequest = async (request: IncomingMessage, response: ServerResponse)
           setHeaders('application/json', null, 'ultra');
           response.end(JSON.stringify(responseBody));
         }
+        // Otherwise, if the service is to receive a disagreement with a diagnosis:
+        else if (segments[0] === 'reportDisagreement') {
+          const {engineID, ruleID, reason} = postData as {engineID: string; ruleID: string; reason: string};
+          // Get the response body.
+          const responseBody = await apiRespond.reportDisagreement(segments.slice(1).concat(engineID, ruleID, reason));
+          await recordPageMetric('apiOperations', 'reportDisagreement');
+          // Send it.
+          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};

package/lhm.plugin.json

@@ -1241,17 +1241,17 @@
                         "how to get details about the element": {
                           "type": "object",
                           "properties": {
-                            "URL": {
-                              "type": "string"
-                            },
-                            "request method": {
+                            "method": {
                               "type": "string",
                               "const": "GET"
+                            },
+                            "URL": {
+                              "type": "string"
                             }
                           },
                           "required": [
-                            "URL",
-                            "request method"
+                            "method",
+                            "URL"
                           ],
                           "additionalProperties": false
                         },
@@ -3371,6 +3371,336 @@
         "taskSupport": "forbidden"
       }
     },
+    {
+      "name": "reportDisagreement",
+      "description": "Reports that you disagree with a diagnosis shown by the listDiagnoses tool; queued for manager review. Use this after listDiagnoses when you believe a rule violation was incorrectly diagnosed or classified into an issue, providing the engineID and ruleID shown in the diagnosis and your reason. Returns a confirmation with disposition details.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "issueID": {
+            "type": "string",
+            "description": "Issue identifier (example: contrastPoor)"
+          },
+          "reportID": {
+            "type": "string",
+            "description": "Identifier of the report (example: 260503T0432-x9z)"
+          },
+          "catalogIndex": {
+            "type": "string",
+            "description": "Identifier of the issue-exhibiting element in the catalog of elements on the page (example: 372)"
+          },
+          "engineID": {
+            "type": "string",
+            "description": "Identifier of the rule engine that produced the disputed diagnosis (example: axe), as shown in the listDiagnoses output"
+          },
+          "ruleID": {
+            "type": "string",
+            "description": "Identifier of the rule whose diagnosis is disputed, as shown in the listDiagnoses output (example: color-contrast); if that output shows null for the rule identifier, use its description of the violation instead"
+          },
+          "reason": {
+            "type": "string",
+            "description": "20- to 1000-character explanation of why the diagnosis is disputed"
+          }
+        },
+        "required": [
+          "issueID",
+          "reportID",
+          "catalogIndex",
+          "engineID",
+          "ruleID",
+          "reason"
+        ],
+        "$schema": "http://json-schema.org/draft-07/schema#"
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "tool collection": {
+            "$ref": "#/definitions/ToolsFacts"
+          },
+          "tool name": {
+            "type": "string"
+          },
+          "this request": {
+            "type": "object",
+            "properties": {
+              "description": {
+                "type": "string"
+              },
+              "method": {
+                "type": "string",
+                "const": "POST"
+              },
+              "URL": {
+                "type": "string"
+              },
+              "body": {
+                "type": "object",
+                "properties": {
+                  "engineID": {
+                    "type": "string",
+                    "description": "Identifier of the rule engine that produced the disputed diagnosis (example: axe), as shown in the listDiagnoses output"
+                  },
+                  "ruleID": {
+                    "type": "string",
+                    "description": "Identifier of the rule whose diagnosis is disputed, as shown in the listDiagnoses output (example: color-contrast); if that output shows null for the rule identifier, use its description of the violation instead"
+                  },
+                  "reason": {
+                    "type": "string",
+                    "description": "20- to 1000-character explanation of why the diagnosis is disputed"
+                  }
+                },
+                "required": [
+                  "engineID",
+                  "ruleID",
+                  "reason"
+                ],
+                "additionalProperties": false
+              },
+              "closest ancestor request": {
+                "anyOf": [
+                  {
+                    "$ref": "#/definitions/RequestReference"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              }
+            },
+            "required": [
+              "description",
+              "method",
+              "URL",
+              "body",
+              "closest ancestor request"
+            ],
+            "additionalProperties": false
+          },
+          "URLs of similar requests for web users": {
+            "type": "null"
+          },
+          "response metadata": {
+            "$ref": "#/definitions/ResponseMetadata"
+          },
+          "response content": {
+            "type": "object",
+            "properties": {
+              "details about your request": {
+                "anyOf": [
+                  {
+                    "type": "object",
+                    "properties": {
+                      "error": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "error"
+                    ],
+                    "additionalProperties": false
+                  },
+                  {
+                    "type": "object",
+                    "properties": {
+                      "date and time received": {
+                        "type": "string"
+                      },
+                      "diagnosis you disagree with": {
+                        "type": "object",
+                        "properties": {
+                          "issue identifier": {
+                            "type": "string"
+                          },
+                          "identifier of the rule engine": {
+                            "type": "string"
+                          },
+                          "identifier of the violated rule": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "issue identifier",
+                          "identifier of the rule engine",
+                          "identifier of the violated rule"
+                        ],
+                        "additionalProperties": false
+                      },
+                      "disposition": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "date and time received",
+                      "diagnosis you disagree with",
+                      "disposition"
+                    ],
+                    "additionalProperties": false
+                  }
+                ]
+              }
+            },
+            "required": [
+              "details about your request"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "required": [
+          "tool collection",
+          "tool name",
+          "this request",
+          "URLs of similar requests for web users",
+          "response metadata",
+          "response content"
+        ],
+        "$schema": "http://json-schema.org/draft-07/schema#",
+        "additionalProperties": false,
+        "definitions": {
+          "ToolsFacts": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string"
+              },
+              "description": {
+                "type": "object",
+                "properties": {
+                  "what Kilotest does": {
+                    "type": "string"
+                  },
+                  "how to retrieve findings": {
+                    "type": "object",
+                    "properties": {
+                      "level 1": {
+                        "type": "string"
+                      },
+                      "level 2": {
+                        "type": "string"
+                      },
+                      "level 3": {
+                        "type": "string"
+                      },
+                      "level 4": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "level 1",
+                      "level 2",
+                      "level 3",
+                      "level 4"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "how to generate more findings": {
+                    "type": "object",
+                    "properties": {
+                      "new testing": {
+                        "type": "string"
+                      },
+                      "retesting": {
+                        "type": "string"
+                      },
+                      "latency": {
+                        "type": "string"
+                      },
+                      "confirmation": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "new testing",
+                      "retesting",
+                      "latency",
+                      "confirmation"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "required": [
+                  "what Kilotest does",
+                  "how to retrieve findings",
+                  "how to generate more findings"
+                ],
+                "additionalProperties": false,
+                "description": "Explanation of what Kilotest does and how to use its tools."
+              },
+              "URL": {
+                "type": "string",
+                "description": "URL of the Kilotest MCP server."
+              },
+              "web users can obtain similar functionalities at": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "name",
+              "description",
+              "URL",
+              "web users can obtain similar functionalities at"
+            ],
+            "additionalProperties": false
+          },
+          "RequestReference": {
+            "type": "object",
+            "properties": {
+              "tool name": {
+                "type": "string"
+              },
+              "description": {
+                "type": "string"
+              },
+              "method": {
+                "type": "string",
+                "enum": [
+                  "GET",
+                  "POST"
+                ]
+              },
+              "URL": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "tool name",
+              "description",
+              "method",
+              "URL"
+            ],
+            "additionalProperties": false
+          },
+          "ResponseMetadata": {
+            "type": "object",
+            "properties": {
+              "identifier": {
+                "type": "string",
+                "description": "Unique identifier of this response (timestamp and random suffix)."
+              },
+              "date and time": {
+                "type": "string",
+                "description": "UTC date and time when the response was generated, in ISO 8601 format."
+              }
+            },
+            "required": [
+              "identifier",
+              "date and time"
+            ],
+            "additionalProperties": false
+          }
+        }
+      },
+      "annotations": {
+        "title": "Report disagreement with a diagnosis",
+        "readOnlyHint": false,
+        "destructiveHint": false,
+        "idempotentHint": false,
+        "openWorldHint": false
+      },
+      "execution": {
+        "taskSupport": "forbidden"
+      }
+    },
     {
       "name": "orderNewTest",
       "description": "Orders testing of a page that has no report yet, with automated approval or rejection and immediate enqueueing if approved. Use this instead of requestNewTest when immediate testing is wanted; testing typically takes 2 to 4 minutes. Returns an order confirmation and disposition details, including, if approved, a report identifier (timestamp and job identifier) and a question about whether to wait for completion with the awaitTest tool.",
@@ -4392,5 +4722,5 @@
       }
     }
   ],
-  "version": "61.0.0"
+  "version": "62.0.0"
 }

package/llms-full.txt

@@ -124,6 +124,19 @@ Kilotest offers these tools:
   - path: `/api/requestFeature`
   - payload properties
     - `feature`: description and motivation of the feature improvement or the new feature
+- `reportDisagreement`
+  - method: `POST`
+  - purpose: report disagreement with a diagnosis shown by `listDiagnoses` of how an element exhibited an issue
+  - path: `/api/reportDisagreement/{issueID}/{reportID}/{catalogIndex}`
+  - parameters
+    - `issueID`: identifier of the issue
+    - `reportID`: identifier of the report, with YYMMDDTHHmm format for its initial segment (example: 260503T0432-x9z)
+    - `catalogIndex`: index of the catalog entry of the element
+  - source of parameters: response to a `listDiagnoses` request
+  - payload properties
+    - `engineID`: identifier of the rule engine that produced the disputed diagnosis, shown in the `listDiagnoses` response
+    - `ruleID`: identifier of the rule whose diagnosis is disputed, shown in the `listDiagnoses` response, or, if it is null, the description of the violation
+    - `reason`: 20- to 1000-character explanation of why the diagnosis is disputed
 - `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

package/llms.txt

@@ -12,6 +12,7 @@ Kilotest integrates an ensemble of 12 rule engines, with about 1,300 rules, to t
 - Request testing of a web page: `/api/requestNewTest` (`POST`)
 - Request retesting of a web page: `/api/requestRetest/{reportID}` (`POST`)
 - Request adding or improving a feature: `/api/requestFeature` (`POST`)
+- Report disagreement with a diagnosis: `/api/reportDisagreement/{issueID}/{reportID}/{catalogIndex}` (`POST`)
 - Order immediate, automatically approved testing of a web page: `/api/orderNewTest` (`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`)