From f68284817045c757d03a3dfc4928b0895e5b656b Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 25 Jun 2026 19:37:26 +0000 Subject: [PATCH] docs: weekly sync Sync docs/host-commands.md with the two commits pushed directly to main this week: - f5168d4 package-checker now accepts multiple vendor/package[:version] args, OR-matched, with aggregated per-repo output. - 17a7696 sanity-check disables the safe-uninstall check until a bug in it is fixed. The other direct-push commits this week (16b18c8, 26e6570, 90beb4b) only touched .github/workflows/docs-sync.yml, which is out of the documented scope. Commits 3da67f1, 85e8cc0, f33c21f landed via merged PRs and are covered by the per-PR docs-sync workflow. Co-Authored-By: Claude --- docs/host-commands.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/host-commands.md b/docs/host-commands.md index 45ff304..ba68631 100644 --- a/docs/host-commands.md +++ b/docs/host-commands.md @@ -30,11 +30,11 @@ These commands run on the developer's host machine (via `ddev `), from - `mr` — Pushes the current branch and creates a draft GitLab MR via `glab mr create`, prefilling the title from the branch's `T-` and description suffix. - `open-board` — Opens the Teamwork board for the project, building the URL from `TEAMWORK_PROJECT_ID`/`TEAMWORK_DOMAIN` in `.ddev/.env.anner`. Aliases: `tw-board`. - `open-issue` — Opens (and copies to clipboard) the Teamwork task URL for the `T-` in the current branch name, falling back to the previous branch if needed. Aliases: `tw-open`. -- `package-checker` — Scans every project in a GitLab group for usage (and version) of a given Composer package by reading each project's `composer-manifest.yaml`, optionally flagging insecure versions. Aliases: `wtfiow`. +- `package-checker` — Scans every project in a GitLab group for usage (and version) of one or more Composer packages (`vendor/package` or `vendor/package:max-insecure-version`, OR-matched) by reading each project's `composer-manifest.yaml`, optionally flagging insecure versions; a project is reported as a single aggregated line listing every matching package, in red if any match is insecure. Aliases: `wtfiow`. - `protect` — Enables/disables/resets HTTP basic-auth protection on a nixOS-hosted dev project via nginx config and htpasswd; no-ops unless `ANNERTECH_LOCAL_DEV` is set. - `remote-db` — Pulls the latest database (skipping files) from the configured upstream provider (`DDEV_UPSTREAM_PROVIDER` in `.ddev/.env.anner`) via `ddev pull --skip-files -y`. - `remote-files` — Pulls the latest files (skipping the DB) from the upstream provider via `ddev pull --skip-db -y`. -- `sanity-check` — Runs a suite of Drupal/Composer/DDEV/Upsun health checks (version constraints, performance settings, extensions, safe-uninstall, composer audit, Solr, Upsun project config, APCu, CDN, botbuster) by sourcing scripts from `commands/host/_lib/`. Supports `-s` (silent), `-b`/`--best-practices`, `-o`/`--offline`; exits 2 on critical errors (used to block pushes), 1 on regular errors. +- `sanity-check` — Runs a suite of Drupal/Composer/DDEV/Upsun health checks (version constraints, performance settings, extensions, composer audit, Solr, Upsun project config, APCu, CDN, botbuster) by sourcing scripts from `commands/host/_lib/`. The safe-uninstall check is currently disabled (commented out) pending a fix for a bug in it. Supports `-s` (silent), `-b`/`--best-practices`, `-o`/`--offline`; exits 2 on critical errors (used to block pushes), 1 on regular errors. - `teamwork-operations` — Interactive fzf "Teamwork Operations Centre" dispatching to `open-issue`, `tw-comment`, `tw-timelog`, `tw-description`, `tw-new`, `tw-batch-card-maker`, plus branch creation/switching helpers. Aliases: `tw`. - `tests` — Detects which test suites (Backstop, Behat, Bruno, Cypress, PHPUnit) are configured in the project and prints the commands to run each. - `timew` — Tags the current Timewarrior interval with the branch's `T-` task and the project directory name.