Evaluate WP-CLI package and Trellis extension distribution paths - #187
Merged
Conversation
Two cross-linked documents assessing whether this repo's tooling should ship through the WordPress and Trellis ecosystems' own channels. wp-cli-package-evaluation.md rewrites an earlier draft whose compatibility table was fabricated: it rated wp-cli/migration and wp-cli/seo at 85-90% WP-CLI compatible when neither directory contains PHP, and rated the security scanners at 90% "uses WP_CLI APIs" when they contain zero WP_CLI references. Eighteen of its seventy estimated hours were budgeted against files that do not exist. The rewrite records the verified inventory (16 wp-cli commands: 5 PHP, 11 Bash; exactly one file uses the WP-CLI API), keeps a corrections section since the old conclusions are still circulating, and narrows the recommendation to publishing the one pattern-validate command. It also argues against packaging the scanners, whose lack of WP_CLI coupling is deliberate — it is what lets them run on hosts that have no WP-CLI at all. trellis-extensions-evaluation.md is new. It separates the two mechanisms that "Trellis extension" conflates: Ansible Galaxy roles, which is what the roots.io directory lists, and trellis-cli's undocumented git-style plugin system, verified against trellis-cli v1.19.0 and confirmed by running a plugin. Any executable named trellis-* on PATH becomes a subcommand, so a trellis-wpops symlink makes the existing binary a trellis subcommand with no new code — tested end to end. Records the core-namespace guard that silently skips plugins whose first segment matches a core command, which is why trellis-db-pull can never work. Ecosystem survey finds ~190 stars across three unmaintained projects duplicating trellis/backup, and no published extension doing Nginx log analysis, so the recommendation ships monitoring first. Includes the trellis-sync repo assessment: archived, with its seven open issues answered, and named as the backup role's home over a new repo.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Two cross-linked documents assessing whether this repo's tooling should ship through the WordPress and Trellis ecosystems' own channels.
wp-cli-package-evaluation.md rewrites an earlier draft whose compatibility table was fabricated: it rated wp-cli/migration and wp-cli/seo at 85-90% WP-CLI compatible when neither directory contains PHP, and rated the security scanners at 90% "uses WP_CLI APIs" when they contain zero WP_CLI references. Eighteen of its seventy estimated hours were budgeted against files that do not exist. The rewrite records the verified inventory (16 wp-cli commands: 5 PHP, 11 Bash; exactly one file uses the WP-CLI API), keeps a corrections section since the old conclusions are still circulating, and narrows the recommendation to publishing the one pattern-validate command. It also argues against packaging the scanners, whose lack of WP_CLI coupling is deliberate — it is what lets them run on hosts that have no WP-CLI at all.
trellis-extensions-evaluation.md is new. It separates the two mechanisms that "Trellis extension" conflates: Ansible Galaxy roles, which is what the roots.io directory lists, and trellis-cli's undocumented git-style plugin system, verified against trellis-cli v1.19.0 and confirmed by running a plugin. Any executable named trellis-* on PATH becomes a subcommand, so a trellis-wpops symlink makes the existing binary a trellis subcommand with no new code — tested end to end. Records the core-namespace guard that silently skips plugins whose first segment matches a core command, which is why trellis-db-pull can never work.
Ecosystem survey finds ~190 stars across three unmaintained projects duplicating trellis/backup, and no published extension doing Nginx log analysis, so the recommendation ships monitoring first. Includes the trellis-sync repo assessment: archived, with its seven open issues answered, and named as the backup role's home over a new repo.