From b3fb3c32a2455352b03bf9771d07236850d4af2c Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 9 Jul 2026 19:37:34 +0000 Subject: [PATCH] docs: weekly sync for week of 2026-07-03 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - ai-prompts: document new Antigravity (agy) and Prompt agents added for BackstopJS Init; clarify that Access Log Forensics only supports Gemini/Copilot/Claude - behat: reflect refactored execution order — flag file now touched before any behat lookup; document new root vendor/bin/behat shortcut (uses -c tests/behat/behat.yml and exits early) - tests: already synced in ab93d1b (drush_endpoint reminder) Co-Authored-By: Claude --- docs/host-commands.md | 2 +- docs/web-commands.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/host-commands.md b/docs/host-commands.md index 4c949af..ca202dd 100644 --- a/docs/host-commands.md +++ b/docs/host-commands.md @@ -8,7 +8,7 @@ These commands run on the developer's host machine (via `ddev `), from ## Commands -- `ai-prompts` — Interactive fzf menu ("AI Prompts Operations Centre") offering BackstopJS-init prompt generation (extracts test/reference domains, feeds a templated prompt to a chosen AI agent) and access-log forensics (GDPR-safe IP masking via `mask_ips.py` before sending log excerpts to an LLM). Aliases: `ai`. +- `ai-prompts` — Interactive fzf menu ("AI Prompts Operations Centre") offering two operations: **BackstopJS Init** (extracts `DDEV_PRIMARY_URL`/`STAGE_FILE_PROXY_URL`, populates `scripts/prompts/backstop-init.md`, and sends it to a chosen AI agent — Gemini, Copilot, Claude `sonnet --effort low`, Antigravity `agy --prompt`, or Prompt which simply echoes the content for copy-paste) and **Access Log Forensics** (GDPR-safe prefix-preserving IPv4 masking via `mask_ips.py` before sending to Gemini, Copilot, or Claude). Aliases: `ai`. - `annertech-tip-of-the-day` — Installs (or removes with `-u`/`--uninstall`) a custom DDEV "tip of the day" remote-config entry in `~/.ddev/global_config.yaml` pointing at Annertech's tips repo, clearing DDEV state so the change takes effect. Note: header `## Usage` says `install-tips`, which is stale/inconsistent with the actual filename. - `backstop-public` — Copies the BackstopJS HTML report into the web root so it's reachable over HTTP, prints the URL, and deletes the copy automatically after 5 minutes. - `branch` — Creates a git branch named `YYYYMM_T-__` from a Teamwork card URL/ID and description. Blocks branching from forbidden base branches (dev/develop/development/stage/staging) and warns to pull first when branching from main/master. Aliases: `branch`, `br`. diff --git a/docs/web-commands.md b/docs/web-commands.md index 1d746aa..1b2ce15 100644 --- a/docs/web-commands.md +++ b/docs/web-commands.md @@ -6,7 +6,7 @@ Note: `install-varnish` exists in this directory but is intentionally not docume ## Commands -- `behat` — Runs Behat tests. Errors if `tests/behat` doesn't exist; `cd`s into it, runs `composer install`, then touches `web/.behat_testing` (a flag file read by `settings.local.devmode.php`/`settings.local.perfmode.php` to disable captcha/antibot and force-enable CSS/JS aggregation during test runs) before invoking `bin/behat "$@"`. The flag file is removed via a `trap` on EXIT/INT/TERM. Includes a comment noting `big_pipe` should be disabled/re-enabled in `FeatureContext.php`'s suite hooks since it conflicts with Behat. +- `behat` — Runs Behat tests. Immediately touches `web/.behat_testing` (a flag file read by `settings.local.devmode.php`/`settings.local.perfmode.php` to disable captcha/antibot during test runs) and sets a `trap` to remove it on EXIT/INT/TERM. If `vendor/bin/behat` exists at the project root, it is invoked directly as `vendor/bin/behat -c tests/behat/behat.yml "$@"` and the command exits. Otherwise, errors if `tests/behat` doesn't exist, `cd`s into it, runs `composer install`, and invokes `bin/behat "$@"`. Includes a comment noting `big_pipe` should be disabled/re-enabled in `FeatureContext.php`'s suite hooks since it conflicts with Behat. - `check-annertech-ddev` — Checks whether the installed annertech-ddev addon is current: reads the local version from `.ddev/addon-metadata/annertech-ddev/manifest.yaml`, fetches the latest GitHub release tag (cached for 24 hours in `/tmp`), compares with `sort -V`, and prints an "Up to date" or "Update required!" message with upgrade instructions. - `install-bruno` — Sets up Bruno API-test configuration: determines the main branch, fetches Dev/Live environment URLs via `platform url`, copies a Bruno template into `tests/bruno`, strips `#ddev-generated` markers from `.bru` files, and substitutes the `DEV_URL`/`LIVE_URL` placeholders in the environment files. - `phpunit` — Runs PHPUnit. Verifies `vendor/bin/phpunit` exists (errors if `drupal/core-dev` isn't required), then runs it from `$DOCROOT` with `--config ../.ddev`, forwarding all arguments.