Accept absolute host paths as command arguments

[jrockowitz]

Summary

Every command sets ## HostWorkingDir: true, which maps the host's current working directory into the container. Command arguments, however, are passed through verbatim — so an absolute host path (e.g. /Users/me/Sites/project/web/modules/custom/foo) arrives inside the container unchanged and fails to resolve, because the project is mounted at ${DDEV_APPROOT} (/var/www/html).

This is awkward for IDE "external tools", file watchers, and AI agents, which naturally work with full host paths.

This PR adds a small shared helper, module-developer/lib/host-paths.sh, that rewrites absolute host-path arguments to their in-container equivalent. Every command in commands/web/ sources it and normalizes "$@" immediately after binary resolution and before any defaulting/exec.

How it works

ddev_normalize_host_paths strips leading path components from an absolute argument until the remainder resolves under ${DDEV_APPROOT}. This is host-root agnostic — no docroot or host-prefix assumption — so paths anywhere in the project (including a top-level recipes/ directory) are handled.

It is a no-op for:

• relative paths (web/modules/custom/foo),
• flags (--standard=Drupal),
• absolute paths that already exist in the container,
• absolute paths that do not resolve under the project root.

source /mnt/ddev_config/module-developer/lib/host-paths.sh
ddev_normalize_host_paths "$@"
set -- "${DDEV_NORMALIZED_ARGS[@]}"

Known limitation

Absolute paths containing glob wildcards (e.g. /abs/path/**/*.css for stylelint) are left untouched, since the path cannot be matched by an existence test as it stands. Pass those patterns relative to the project root. This is documented in the README.

Tests

Adds tests/host-path-args.bats (4 tests, all passing locally) covering: absolute host path rewritten to the container path, relative path passed through unchanged, unresolvable absolute path left untouched, and phpcs rewriting an absolute argument. Verified end-to-end on a real DDEV Drupal project: an absolute host path produces output identical to the relative equivalent, whereas a raw un-rewritten host path fails with a path-not-found error.

Docs

• README.md — new "Absolute host paths" subsection.
• AGENTS.md — helper added to the repo layout, a new "normalize host-path arguments" step, and a contributor invariant.

AI-assisted by Claude Code.

[jrockowitz]

CI fix: Homebrew Bubblewrap sandbox failure

A heads-up on the two CI commits I pushed (HOMEBREW_NO_SANDBOX_LINUX in .github/workflows/tests.yml).

Symptom: the tests jobs started failing during setup — at the brew install step of ddev/github-action-add-on-test@v2, before any Bats test ran:

Bubblewrap is installed but cannot create a rootless sandbox.

The job aborted in ~54s (a normal run is ~2–3 min). This is not a test regression — an earlier run on this PR and the main pushes earlier that day passed with the same action. It's a recent Homebrew change: newer Homebrew enables a Bubblewrap build sandbox that can't initialise on GitHub's hosted runners, so the tooling install aborts.

Fix: disable Homebrew's Linux sandbox at the job level — the variable Homebrew's own error message recommends:

jobs:
  tests:
    env:
      HOMEBREW_NO_SANDBOX_LINUX: "1"

(My first attempt used HOMEBREW_NO_SANDBOX, which only governs the macOS sandbox-exec sandbox — the Linux Bubblewrap sandbox needs the _LINUX variant.)

Result: both matrix jobs pass again — tests (stable) and tests (HEAD) green, full Bats suite (including the new host-path-args.bats) runs with zero failures.

Note this is independent of the absolute-host-path feature in this PR — it would hit main and every other PR too, so it's probably worth keeping (or applying on main) regardless of how you feel about the rest of the change.

[stasadev]

Fix: disable Homebrew's Linux sandbox at the job level

This is an upstream problem, and I pushed a new release for our action https://github.com/ddev/github-action-add-on-test/releases/tag/v2.4.4