docs: add local html failure shape to llms

Author: aaronlab

LAUNCH.md

@@ -117,7 +117,7 @@ Current latest audit:
 
 | Captured at | Stars | To 1001 | Forks | Watchers | Issues | PRs | Release downloads | Note |
 |---|---:|---:|---:|---:|---:|---:|---:|---|
-| 2026-05-12T13:10:31+00:00 | 3 | 998 | 21 | 0 | 10 | 0 | 40 | current monitor pass after owner-action issues #9 and #10 were refreshed with the updated social/email packets and current metrics: https://github.com/aaronlab/browsertrace/issues/9#issuecomment-4430804562 and https://github.com/aaronlab/browsertrace/issues/10#issuecomment-4430804580; star goal remains incomplete; traffic views 354/132 unique, clones 16382/2819 unique |
+| 2026-05-12T13:15:41+00:00 | 3 | 998 | 21 | 0 | 10 | 0 | 40 | current monitor pass after llms.txt added the Browser Use local HTML upload navigation failure shape for AI/coding-agent discovery; star goal remains incomplete; traffic views 354/132 unique, clones 16382/2819 unique |
 
 The active objective is incomplete until `stargazerCount > 1000`.
 

docs/launch/metrics-log.md

@@ -1045,3 +1045,4 @@ uv run --python 3.11 python scripts/launch_metrics.py --json
 | 2026-05-12T12:59:48+00:00 | 3 | 998 | 21 | 0 | 10 | 0 | 40 | current monitor pass after contributor PR #357 merged, issue #352 closed, pinned good-first issue rotated to #358, and launch discussion queue refreshed: https://github.com/aaronlab/browsertrace/discussions/6#discussioncomment-16892678; CI 25735861674 and Pages 25735861711 succeeded; star goal remains incomplete; traffic views 354/132 unique, clones 16382/2819 unique |
 | 2026-05-12T13:06:01+00:00 | 3 | 998 | 21 | 0 | 10 | 0 | 40 | current monitor pass after owner-facing social, email, Show HN, and Product Hunt packets added the Browser Use local HTML upload navigation failure pattern; current pinned good-first issue is #358; star goal remains incomplete; traffic views 354/132 unique, clones 16382/2819 unique |
 | 2026-05-12T13:10:31+00:00 | 3 | 998 | 21 | 0 | 10 | 0 | 40 | current monitor pass after owner-action issues #9 and #10 were refreshed with the updated social/email packets and current metrics: https://github.com/aaronlab/browsertrace/issues/9#issuecomment-4430804562 and https://github.com/aaronlab/browsertrace/issues/10#issuecomment-4430804580; star goal remains incomplete; traffic views 354/132 unique, clones 16382/2819 unique |
+| 2026-05-12T13:15:41+00:00 | 3 | 998 | 21 | 0 | 10 | 0 | 40 | current monitor pass after llms.txt added the Browser Use local HTML upload navigation failure shape for AI/coding-agent discovery; star goal remains incomplete; traffic views 354/132 unique, clones 16382/2819 unique |

docs/llms.txt

@@ -69,6 +69,12 @@ to explain why a browser run failed.
   indexes, focused page before/after, `pages_before`, `pages_after`,
   `new_pages`, action id, URL/title probe status, and any
   `recommended_next_action` such as `switch_tab`.
+- Browser Use local HTML upload navigation: an uploaded local HTML file or
+  attachment name can be misread as a navigation target before the intended
+  upload action runs. Preserve the task prompt, model-visible attachment
+  context, local filename/extension/MIME type when safe, raw model action,
+  parsed action type and rejected URL or upload target, watchdog block reason,
+  allowed-domains state, and recovery recommendation.
 - Stagehand custom tool replay gap: when cached normal page actions replay but
   a custom tool is skipped, separate the replay contract from the diagnostic trace contract.
   For replay, capture tool name, serialized args, stable

llms.txt

@@ -69,6 +69,12 @@ to explain why a browser run failed.
   indexes, focused page before/after, `pages_before`, `pages_after`,
   `new_pages`, action id, URL/title probe status, and any
   `recommended_next_action` such as `switch_tab`.
+- Browser Use local HTML upload navigation: an uploaded local HTML file or
+  attachment name can be misread as a navigation target before the intended
+  upload action runs. Preserve the task prompt, model-visible attachment
+  context, local filename/extension/MIME type when safe, raw model action,
+  parsed action type and rejected URL or upload target, watchdog block reason,
+  allowed-domains state, and recovery recommendation.
 - Stagehand custom tool replay gap: when cached normal page actions replay but
   a custom tool is skipped, separate the replay contract from the diagnostic trace contract.
   For replay, capture tool name, serialized args, stable

tests/test_metadata.py

@@ -3162,6 +3162,19 @@ def test_llms_txt_includes_browser_use_new_tab_desync_shape():
     assert "upvotes" not in llms.lower()
 
 
+def test_llms_txt_includes_browser_use_local_html_upload_navigation_shape():
+    project_root = Path(__file__).resolve().parents[1]
+    llms = (project_root / "docs" / "llms.txt").read_text()
+
+    assert "Browser Use local HTML upload navigation" in llms
+    assert "model-visible attachment" in llms
+    assert "local filename/extension/MIME type" in llms
+    assert "watchdog block reason" in llms
+    assert "allowed-domains state" in llms
+    assert "stars" not in llms.lower()
+    assert "upvotes" not in llms.lower()
+
+
 def test_llms_txt_includes_stagehand_custom_tool_replay_shape():
     project_root = Path(__file__).resolve().parents[1]
     llms = (project_root / "docs" / "llms.txt").read_text()