lighthouse 13.4.0 → 13.4.1

package/.agents/skills/lighthouse-verification/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: lighthouse-verification
+description: Instructions for how to validate changes made to Lighthouse. Must invoke when making changes to Lighthouse.
+---
+
+# Lighthouse verification
+
+Run a subset of the unit tests like this:
+
+```
+yarn mocha test/files/to/run
+```
+
+Don't run "yarn unit" - it takes too long.
+
+Run typechecking and linter:
+
+```
+yarn type-check
+yarn lint --fix
+```
+
+Make sure to run some unit tests and the type-checker / linter after making changes.
+
+Always run `yarn update:sample-json` after making any change.

package/core/audits/agentic/agent-accessibility-tree.js

@@ -13,8 +13,9 @@ const UIStrings = {
   /** Title shown when one or more agent accessibility checks fail. */
   failureTitle: 'Accessibility tree is not well-formed',
   /** Description of a Lighthouse audit that tells the user *why* they need a well-formed accessibility tree. */
-  description: 'A well-formed [accessibility tree](http://goo.gle/lighthouse-agentic-a11y) helps AI agents to ' +
-    'navigate and interact with the page.',
+  description: 'A well-formed ' +
+  '[accessibility tree](https://developer.chrome.com/docs/lighthouse/agentic-browsing/accessibility-for-agents) ' +
+  'helps AI agents to navigate and interact with the page.',
   /** Label of a table column that identifies the accessibility rule that failed. */
   columnRule: 'Failing Rule',
   /** Label of a table column that identifies the HTML element that failed the rule. */

package/core/audits/agentic/llms-txt.d.ts

@@ -11,6 +11,7 @@ export namespace UIStrings {
     let failureTitle: string;
     let description: string;
     let displayValueHttpBadCode: string;
+    let explanationWithError: string;
     let explanation: string;
     let missingH1: string;
     let tooShort: string;

package/core/audits/agentic/llms-txt.js

@@ -19,12 +19,18 @@ const UIStrings = {
   description: 'If your llms.txt file does not follow recommendations, ' +
     'large language models may not be able to ' +
     'understand how you want your website to be crawled or used for training. The ' +
-    '[llms.txt](https://llmstxt.org/) file should be a Markdown file containing at least one H1 header.',
+    '[llms.txt](https://llmstxt.org/) file should be a Markdown file containing at least one H1 header. ' +
+    '[Learn more about the llms.txt audit](https://developer.chrome.com/docs/lighthouse/agentic-browsing/llms-txt).',
   /**
    * @description Label for the audit identifying that the request failed with a specific HTTP status code.
    * @example {500} statusCode
    * */
   displayValueHttpBadCode: 'Failed with HTTP status {statusCode}',
+  /**
+   * @description Explanatory message stating that there was a failure in an audit caused by Lighthouse not being able to download the llms.txt file for the site.  Note: "llms.txt" is a canonical filename and should not be translated.
+   * @example {Timed out fetching resource} error
+   * */
+  explanationWithError: 'Fetch of llms.txt failed: {error}',
   /** Explanatory message stating that there was a failure in an audit caused by Lighthouse not being able to download the llms.txt file for the site.  Note: "llms.txt" is a canonical filename and should not be translated. */
   explanation: 'Fetch of llms.txt failed',
   /** Message indicating that the file is missing a required H1 header. */
@@ -59,8 +65,16 @@ class LlmsTxt extends Audit {
     const {
       status,
       content,
+      errorMessage,
     } = artifacts.LlmsTxt;
 
+    if (errorMessage) {
+      return {
+        score: 0,
+        explanation: str_(UIStrings.explanationWithError, {error: errorMessage}),
+      };
+    }
+
     if (!status) {
       return {
         score: 0,