Skip to content

docs: weekly sync #156

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
bserem wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: weekly sync #156

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/host-commands.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ These commands run on the developer's host machine (via `ddev <command>`), 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-<taskid>__<description>` 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`.
Expand Down
2 changes: 1 addition & 1 deletion docs/web-commands.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
Loading