carson 2.9.0 → 2.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 45443353a34297748fec8177c152d898dabb8cf7f1641d7870b7aff59d9a2f6c
-  data.tar.gz: 627bdc81dcf78ad41998840796a3427512c39b6b2e80e2b961895bdf4423a456
+  metadata.gz: 9b99975ce01b36b30e333553f7c491ebbf92591a3bc7dbc492633984b80a807a
+  data.tar.gz: 55c64697792a9400be1fef45a68731ac7eab6be3be517c79ae2caebd5f5edc9c
 SHA512:
-  metadata.gz: 96a9e858b5d934d5e5570443e25b79e28255cfe54279623be8d44474e55d592a7c9cd3161da8611d84fd24141cd10a98b6922fb364609630d843f651858bf78c
-  data.tar.gz: ee85efae91e54e07d872c560ad7305553b3d45246f9ec502b6fef5b7d1e6e843c8a03787629adb55190541cf5101be76a3f3ee625ec31540876b718905013ba4
+  metadata.gz: c716497d2db2c235dc5d8fa90c65fda8002722cabd7e8425305ce9c26917ebd48e905aed20564393d01178bd8d12257606097fdbf3ab1a77be71d1e48dc08681
+  data.tar.gz: 7f5358b84901463fbd1b211c3094df9c7c46566f9decc3a99d4d643264fc76e79de8b3c298d642c6efac41ecc16aa07647b52e66b6a822f7fff842345dfd9ab6

data/API.md

@@ -95,6 +95,7 @@ Environment overrides:
 - `CARSON_REVIEW_DISPOSITION_PREFIX`
 - `CARSON_REVIEW_SWEEP_WINDOW_DAYS`
 - `CARSON_REVIEW_SWEEP_STATES`
+- `CARSON_WORKFLOW_STYLE`
 - `CARSON_RUBY_INDENTATION`
 
 `lint.languages` schema:

data/MANUAL.md

@@ -212,6 +212,7 @@ Common environment overrides:
 | `CARSON_REVIEW_DISPOSITION_PREFIX` | Required prefix for disposition comments. |
 | `CARSON_REVIEW_SWEEP_WINDOW_DAYS` | Lookback window for review sweep. |
 | `CARSON_REVIEW_SWEEP_STATES` | PR states to include in sweep. |
+| `CARSON_WORKFLOW_STYLE` | Workflow style override (`branch` or `trunk`). |
 | `CARSON_RUBY_INDENTATION` | Ruby indentation policy (`tabs`, `spaces`, or `either`). |
 
 For the full configuration schema and `lint.languages` definition, see `API.md`.

data/RELEASE.md

@@ -5,6 +5,19 @@ Release-note scope rule:
 - `RELEASE.md` records only version deltas, breaking changes, and migration actions.
 - Operational usage guides live in `MANUAL.md` and `API.md`.
 
+## 2.10.0 — Lower Ruby Requirement to 3.4
+
+### What changed
+
+- **Minimum Ruby version lowered from 4.0 to 3.4.** Carson uses no Ruby 4.0-specific features. Lowering to 3.4 widens compatibility to the current stable Ruby series while enabling the `it` implicit block parameter.
+- **Removed `# frozen_string_literal: true` pragma** from the one file that had it (`lib/carson/policy/ruby/lint.rb`). Ruby 4.0 freezes strings by default; the pragma is unnecessary.
+- **Default workflow style now actually `branch` in code.** The 2.9.0 release notes documented this change, but the hooks and config default were not updated. Now fixed: hooks fall back to `branch`, config default is `branch`, and `CARSON_WORKFLOW_STYLE` env override is documented.
+
+### What users must do now
+
+1. Upgrade Carson to `2.10.0`.
+2. Ruby 3.4 or later is now sufficient — Ruby 4.0 is no longer required.
+
 ## 2.9.0 — Concise UX for All Commands
 
 ### What changed
@@ -14,16 +27,19 @@ Release-note scope rule:
 - **Audit concise output.** A healthy audit prints one line (`Audit: ok`). Problems print only actionable summaries (e.g. `Hooks: mismatch — run carson prepare.`).
 - **Refresh concise output.** Prints ~5 lines: hooks installed, templates in sync, audit result, done.
 - **All other commands.** `prepare`, `inspect`, `offboard`, `template check/apply`, `prune`, `review gate/sweep`, `govern`, `lint setup`, `setup`, and `housekeep` all follow the same concise/verbose pattern.
+- **Default workflow style changed from `trunk` to `branch`.** All governed repositories now enforce PR-only merges by default. Direct commits, merge commits, and pushes to protected branches (`main`/`master`) are blocked by hooks unless explicitly opted out.
 
 ### What users must do now
 
 1. Upgrade Carson to `2.9.0`.
 2. Use `--verbose` when you need full diagnostics (debugging, CI troubleshooting).
+3. If you rely on direct commits to main, re-run `carson setup` and choose `trunk`, or set `CARSON_WORKFLOW_STYLE=trunk` in your environment.
 
 ### Breaking or removed behaviour
 
 - Default output is now concise. Scripts that parse Carson's key-value diagnostic lines must add `--verbose`.
 - Removed `@concise` internal flag (replaced by `--verbose` opt-in pattern).
+- Default `workflow.style` changed from `trunk` to `branch`. Repositories that previously relied on the implicit `trunk` default will now block direct commits to protected branches. Escape hatches: run `carson setup` to choose `trunk`, or set `CARSON_WORKFLOW_STYLE=trunk`.
 
 ### Upgrade steps
 
@@ -41,16 +57,14 @@ carson version
 - **Concise onboard output.** `carson onboard` now prints a clean 8-line summary instead of verbose internal state (hook paths, template statuses, config lines). Tells users what happened, what needs attention, and what to do next.
 - **Graceful handling of fresh repos.** Onboard no longer fails with a fatal error on repositories with no commits yet.
 - **Suppressed RubyGems PATH warning.** The misleading `WARNING: You don't have ... in your PATH, gem executables will not run` message from `gem install --user-install` is now suppressed during installation. Carson symlinks the executable to `~/.carson/bin`, making the gem bin directory irrelevant.
-- **Default workflow style changed from `trunk` to `branch`.** All governed repositories now enforce PR-only merges by default. Direct commits, merge commits, and pushes to protected branches (`main`/`master`) are blocked by hooks unless explicitly opted out.
 
 ### What users must do now
 
 1. Upgrade Carson to `2.8.1`.
-2. If you rely on direct commits to main, re-run `carson setup` and choose `trunk`, or set `CARSON_WORKFLOW_STYLE=trunk` in your environment.
 
 ### Breaking or removed behaviour
 
-- Default `workflow.style` changed from `trunk` to `branch`. Repositories that previously relied on the implicit `trunk` default will now block direct commits to protected branches. Escape hatches: run `carson setup` to choose `trunk`, or set `CARSON_WORKFLOW_STYLE=trunk`.
+- None.
 
 ### Upgrade steps
 

data/VERSION

@@ -1 +1 @@
-2.9.0
+2.10.0

data/carson.gemspec

@@ -11,7 +11,7 @@ Gem::Specification.new do |spec|
 	spec.description = "Carson runs outside host repositories and applies governance checks, review gates, and managed GitHub-native files."
 	spec.homepage = "https://github.com/wanghailei/carson"
 	spec.license = "MIT"
-	spec.required_ruby_version = ">= 4.0"
+	spec.required_ruby_version = ">= 3.4"
 	spec.metadata = {
 		"source_code_uri" => "https://github.com/wanghailei/carson",
 		"changelog_uri" => "https://github.com/wanghailei/carson/blob/main/RELEASE.md",

data/hooks/pre-merge-commit

@@ -2,7 +2,7 @@
 set -euo pipefail
 
 hooks_dir="$(cd "$(dirname "$0")" && pwd)"
-style="$(cat "$hooks_dir/workflow_style" 2>/dev/null || echo "trunk")"
+style="$(cat "$hooks_dir/workflow_style" 2>/dev/null || echo "branch")"
 [ "$style" = "trunk" ] && exit 0
 
 branch_name="$(git rev-parse --abbrev-ref HEAD)"

data/hooks/pre-push

@@ -2,7 +2,7 @@
 set -euo pipefail
 
 hooks_dir="$(cd "$(dirname "$0")" && pwd)"
-style="$(cat "$hooks_dir/workflow_style" 2>/dev/null || echo "trunk")"
+style="$(cat "$hooks_dir/workflow_style" 2>/dev/null || echo "branch")"
 [ "$style" = "trunk" ] && exit 0
 
 remote_name="${1:-unknown}"

data/hooks/prepare-commit-msg

@@ -2,7 +2,7 @@
 set -euo pipefail
 
 hooks_dir="$(cd "$(dirname "$0")" && pwd)"
-style="$(cat "$hooks_dir/workflow_style" 2>/dev/null || echo "trunk")"
+style="$(cat "$hooks_dir/workflow_style" 2>/dev/null || echo "branch")"
 [ "$style" = "trunk" ] && exit 0
 
 branch_name="$(git rev-parse --abbrev-ref HEAD)"

data/lib/carson/config.rb

@@ -53,7 +53,7 @@ module Carson
 					"languages" => default_lint_languages_data
 				},
 				"workflow" => {
-					"style" => "trunk"
+					"style" => "branch"
 				},
 				"review" => {
 					"bot_usernames" => [],

data/lib/carson/policy/ruby/lint.rb

@@ -1,5 +1,4 @@
 #!/usr/bin/env ruby
-# frozen_string_literal: true
 
 require "open3"
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: carson
 version: !ruby/object:Gem::Version
-  version: 2.9.0
+  version: 2.10.0
 platform: ruby
 authors:
 - Hailei Wang
@@ -88,7 +88,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '4.0'
+      version: '3.4'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="