Skip to content

Tell agents to stop when breeze cannot run, not use a host venv - #75599

Draft
shahar1 wants to merge 1 commit into
apache:mainfrom
shahar1:docs/agents-breeze-unavailable
Draft

shahar1 wants to merge 1 commit into
apache:mainfrom
shahar1:docs/agents-breeze-unavailable

Conversation

@shahar1

@shahar1 shahar1 commented Oct 25, 2026 •

Copy link
Copy Markdown
Contributor
AI Summary

A sandboxed agent was asked to test the Google provider against Airflow 2.11.1. Its breeze calls were refused by the magpie container gateway, which by design does not proxy BuildKit sessions or unlabelled docker inspect lookups. The agent then quietly built a host virtualenv with Airflow 2.11.1 instead of reporting the failure. Two things in AGENTS.md allowed this. It said "never run pytest on the host" while also listing uv run --project ... pytest commands. It also gave no guidance for when breeze is unavailable, and no command for running provider tests against a released Airflow version.

This PR:

  • names the listed uv run --project commands as the only exception to the host rule;
  • tells agents that when a step needs breeze and breeze cannot run, they stop and report which call failed, rather than building a substitute host environment;
  • adds the documented breeze shell --use-airflow-version <VERSION> --mount-sources providers-and-tests route to the generated AGENTS.md commands, via an AGENT-SKILL block in contributing-docs/testing/unit_tests.rst;
  • notes in .apache-magpie-overrides/setup-isolated-setup-install.md that the breeze permission allows only skip the prompt and do not make breeze work behind the container gateway.

Checks run locally:

  • prek run --from-ref upstream/main --stage pre-commit passed, including "Sync AGENTS.md commands from contributing docs" and "Check documented breeze and prek commands exist".
  • The manual stage passed.
  • Skipped: lychee-docker, because Docker was unavailable in the session.
  • Skipped: check-eval-hash. The skill-eval has not been re-run yet, so dev/skill-evals/last-eval-hash.txt is stale and this PR stays a draft until that hash is updated.

The companion magpie change that hints agents on gateway policy refusals is apache/magpie#1810.


Was generative AI tooling used to co-author this PR?
  • Yes — Claude Code (Opus 5.5, Sonnet 5.5)

Generated-by: Claude Code (Opus 5.5, Sonnet 5.5) following the guidelines

AGENTS.md said never to run pytest on the host but also listed
`uv run --project` commands, and had no guidance for when breeze is
unavailable. A sandboxed agent whose breeze calls were refused by the
container gateway built a host virtualenv with Airflow 2.11.1 instead of
reporting the failure.

Narrow the host exception to the listed `uv run` commands, tell agents
to stop and report when breeze cannot run, and document the breeze
command for testing providers against a released Airflow version
(generated from contributing-docs). Note in the magpie override that the
breeze allows do not make breeze work behind the container gateway.
@shahar1 shahar1 changed the title Tell agents to stop when breeze cannot run instead of using a host venv Tell agents to stop when breeze cannot run, not use a host venv Oct 25, 2026
@shahar1
shahar1 marked this pull request as ready for review October 25, 2026 06:56
@shahar1
shahar1 marked this pull request as draft October 25, 2026 07:33

@amoghrajesh amoghrajesh left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Intentionally draft?

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants