chore: import upstream snapshot with attribution

2026-07-13 13:27:52 +08:00
commit 9201ef759e
2096 changed files with 1232387 additions and 0 deletions
@@ -0,0 +1,47 @@
+---
+# Shared tool-calling and sandbox environment hints.
+# gh-aw imports this file; the markdown below (after the closing ---) is
+# appended to the agent's task prompt at runtime via {{#runtime-import}}.
+# Update INSTRUCTIONS in pydantic_ai_gh_aw_shim/cli.py to match.
+---
+
+## Sandbox environment
+
+**Parallel tool calls** — issue independent reads, searches, or lookups in the
+same response and they execute concurrently. Only chain sequentially when one
+call genuinely needs a previous call's result.
+
+**File reading** — read files in large ranges (500+ lines per call). Most Python
+source files fit in one or two calls. Avoid reading 30–80 lines at a time.
+
+**Search tools** — use the native `Grep` and `Glob` tools for codebase search.
+`rg` and `uv` are also available as plain commands via `Bash`.
+
+**Dev environment** — the repo is checked out at `$GITHUB_WORKSPACE`. Dev
+dependencies are **not** pre-installed; run `make install` once before using
+`pytest`, `ruff`, or `pyright`. Prefer `uv run pytest <test_file>` over a bare
+`pytest` call.
+
+**GitHub issue search** — this workflow runs the GitHub toolset in `gh-proxy`
+mode, so there are **no `mcp__github__*` tools**, and the `/search/issues`
+endpoint (`gh issue list --search`, `gh search issues`) returns HTTP 403 via the
+AWF firewall proxy. The issue-**list** endpoint **is** allowed through the
+proxied `gh` CLI, including its server-side `?labels=` filter. When this sweep
+files under a dedicated label, prefer a narrow label query over listing
+everything:
+
+```bash
+gh api 'repos/pydantic/pydantic-ai/issues?state=open&labels=<label>&per_page=100' \
+  --jq '.[] | select(.pull_request == null) | {number, title}'
+```
+
+If this sweep has no dedicated label, or the label filter is inconclusive, widen
+to a full open-issue scan:
+
+```bash
+gh api --paginate 'repos/pydantic/pydantic-ai/issues?state=open&per_page=100' \
+  --jq '.[] | select(.pull_request == null) | {number, title, labels: [.labels[].name]}'
+```
+
+`select(.pull_request == null)` drops PRs, which the issues endpoint also
+returns.