Merge commit '36c66dd290d3ce6eb1ccd310d0c658d4a32bb8eb' as 'repos/effect'

repos/effect/.changeset/wise-flags-shift.md

@@ -0,0 +1,22 @@
+---
+"effect": patch
+---
+
+Refactor unstable CLI global flags to command-scoped declarations.
+
+### Breaking changes
+
+- Remove `GlobalFlag.add`, `GlobalFlag.remove`, and `GlobalFlag.clear`
+- Add `Command.withGlobalFlags(...)` as the declaration API for command/subcommand scope
+- Change `GlobalFlag.setting` constructor to curried form which carries type-level identifier:
+  - before: `GlobalFlag.setting({ flag, ... })`
+  - after: `GlobalFlag.setting("id")({ flag })`
+- Change setting context identity to a stable type-level string:
+  - `effect/unstable/cli/GlobalFlag/${id}`
+
+### Behavior changes
+
+- Global flags are now scoped by command path (root-to-leaf declarations)
+- Out-of-scope global flags are rejected for the selected subcommand path
+- Help now renders only global flags active for the requested command path
+- Setting defaults are sourced from `Flag` combinators (`optional`, `withDefault`) rather than setting constructor defaults