Add --condition-mode option to projects-add-feature-conditionally

[ondrajodas]

Summary

Adds a --condition-mode option to the manage:projects-add-feature-conditionally command, allowing the condition check to be inverted.

Behavior

--condition-mode (default present) controls how the condition feature is evaluated:

• present – add the target feature only to projects that have the condition feature (previous behavior)
• absent – add the target feature only to projects that do not have the condition feature

In both modes, projects that already have the target feature are skipped, and disabled projects are skipped. Invalid --condition-mode values are rejected with a clear error.

Notes

• Default is present, so the change is backward compatible.
• Skip and dry-run messages now reflect the actual state of the project's condition feature.
• The result counter was renamed to projectsSkippedByCondition and the summary line reworded, since in absent mode the skipped projects are the ones that do have the condition feature.
• README.md updated with the new option and an absent example.

Verification

• composer phpcs – passes
• composer phpstan – no errors

[ondrajodas]

# Release Notes
The `manage:projects-add-feature-conditionally` command gains a `--condition-mode=present|absent` option (default `present`). With `present` the target feature is added to projects that have the condition feature; with `absent` it is added to projects that do not have it. Behavior without the option is unchanged.

# Plans for Customer Communication
None required. Internal operator/maintenance CLI tool; no customer-facing change.

# Impact Analysis
Affects only the cli-utils tooling. No new API endpoints are used. Backward compatible: the default mode reproduces the previous behavior. Without -f the command only reads and reports. Risk is limited to applying the target feature to an unintended set of projects if the mode/feature names are wrong; mitigated by the default dry run, up-front feature-existence validation, and rejection of invalid --condition-mode values.

# Change Type
Feature (new option on an existing CLI command).

# Justification
Enables the inverse use case: bulk-enabling a feature on projects that are missing a given feature, not only on those that already have it. No Linear issue associated.

# Deployment Plan
No deployment needed. Ships with the cli-utils image and is available once merged. No config changes or migrations.

# Rollback Plan
Revert the PR. The change is additive (a new option) with no persisted state; reverting restores the prior command with no side effects.

# Post-Release Support Plan
Operators should run without -f first to review the dry-run summary (disabled / skipped-by-condition / already-having-target / updatable counts), then re-run with -f. Watch for Manage API rate limits on full-stack runs over large numbers of projects.

[Copilot]

Pull request overview

This PR extends the manage:projects-add-feature-conditionally CLI command with a --condition-mode option to control whether projects are selected when the condition feature is present (default, backward compatible) or absent (inverted behavior), and updates user-facing output and documentation accordingly.

Changes:

• Added --condition-mode (present|absent) input option with validation and plumbing through all processing paths.
• Updated per-project output and result counters/summary to reflect whether the condition was met.
• Updated README.md usage and examples to document the new option and inverted mode.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File	Description
src/Keboola/Console/Command/ProjectsAddFeatureConditionally.php	Adds --condition-mode option, validates it, applies inverted condition logic, and updates skip/output + summary counters.
README.md	Documents the new --condition-mode option and provides an absent mode example.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[odinuv]

asi lgbt

[ondrajodas]

asi jo, mám to vyzkoušený na obou PAYGO stacích