carson 2.27.0 → 2.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b07e53b67d21543ee131ce2a8bbc906938fbd657f79973aaa59008911dd14df7
-  data.tar.gz: 73d0811c01b3daa2f397dd545a266085950d93d4cda474ab3288b6b754cd5d20
+  metadata.gz: 7117079168b4f8472a4324f954bc087122e0ded0d253252b73702c41d3996283
+  data.tar.gz: 21484878bcafe5799dfd87a18c223b5982d6b2ff1ab988c78f929de9cd642bdd
 SHA512:
-  metadata.gz: 9880a422abf831615af431cf9b32b6a28a0cd026f2154a46270664deb4d8d32dacf0dac4912a2e64984889372a43bd3cf36cd1cd87899c7b4e3c5cf7ae989fab
-  data.tar.gz: 11e37eb20e6f62dd632493c134218a714dab0a565b533681b1f57b78f28f01dd799786d2d461285dd7623d2832b29f4d3e72f2d95a273f8c80e5869d49f72cd6
+  metadata.gz: bb4b347d7ace09997a93b40fc7ec179baf4eb8aee75a620e3511d4ac7b9c46545380f7157ac442807e09cc1a679e8709a62df1a237a41618501688162f99c511
+  data.tar.gz: 91aaf60433a82548170eb66eef14ce90c0eb730a3a56e06f7c154449d2355ca50f9a1e282d1b26e372c34b1df2946cb804587854875c14d1ffec3da5d6658bff

data/RELEASE.md

@@ -5,6 +5,27 @@ 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.28.0 — Non-Interactive CLI Flags for Setup
+
+### What changed
+
+- **`carson setup` now accepts optional CLI flags** to configure settings without interactive prompts:
+  - `--remote NAME` sets `git.remote`
+  - `--main-branch NAME` sets `git.main_branch`
+  - `--workflow STYLE` sets `workflow.style` (branch or trunk)
+  - `--merge METHOD` sets `govern.merge.method` (squash, rebase, or merge)
+  - `--canonical PATH` sets `template.canonical`
+- When any flag is present, interactive prompts are skipped and only the specified values are written.
+- When no flags are present, existing behaviour is preserved (interactive in TTY, silent detection in non-TTY).
+
+### Why
+
+Running `carson setup` in non-TTY environments (CI pipelines, agent scripts) previously required manually editing `config.json`. CLI flags allow fully automated configuration without file manipulation.
+
+### Migration
+
+No action required. Existing behaviour is unchanged when no flags are provided.
+
 ## 2.27.0 — Absorbed Branch Pruning
 
 ### What changed

data/VERSION

@@ -1 +1 @@
-2.27.0
+2.28.0

data/lib/carson/cli.rb

@@ -53,7 +53,7 @@ module Carson
 
 		def self.build_parser
 			OptionParser.new do |opts|
-				opts.banner = "Usage: carson [setup|audit|sync|prune|onboard [repo_path]|refresh [--all|repo_path]|offboard [repo_path]|template check|template apply|review gate|review sweep|govern [--dry-run] [--json] [--loop SECONDS]|version]"
+				opts.banner = "Usage: carson [setup [--remote NAME] [--main-branch NAME] [--workflow STYLE] [--merge METHOD] [--canonical PATH]|audit|sync|prune|onboard [repo_path]|refresh [--all|repo_path]|offboard [repo_path]|template check|template apply|review gate|review sweep|govern [--dry-run] [--json] [--loop SECONDS]|version]"
 			end
 		end
 
@@ -74,6 +74,8 @@ module Carson
 			when "version"
 				parser.parse!( argv )
 				{ command: "version" }
+			when "setup"
+				parse_setup_command( argv: argv, parser: parser, err: err )
 			when "onboard", "offboard"
 				parse_repo_path_command( command: command, argv: argv, parser: parser, err: err )
 			when "refresh"
@@ -90,6 +92,28 @@ module Carson
 			end
 		end
 
+		def self.parse_setup_command( argv:, parser:, err: )
+			options = {}
+			setup_parser = OptionParser.new do |opts|
+				opts.banner = "Usage: carson setup [--remote NAME] [--main-branch NAME] [--workflow STYLE] [--merge METHOD] [--canonical PATH]"
+				opts.on( "--remote NAME", "Git remote name" ) { |v| options[ "git.remote" ] = v }
+				opts.on( "--main-branch NAME", "Main branch name" ) { |v| options[ "git.main_branch" ] = v }
+				opts.on( "--workflow STYLE", "Workflow style (branch or trunk)" ) { |v| options[ "workflow.style" ] = v }
+				opts.on( "--merge METHOD", "Merge method (squash, rebase, or merge)" ) { |v| options[ "govern.merge.method" ] = v }
+				opts.on( "--canonical PATH", "Canonical template directory path" ) { |v| options[ "template.canonical" ] = v }
+			end
+			setup_parser.parse!( argv )
+			unless argv.empty?
+				err.puts "#{BADGE} Unexpected arguments for setup: #{argv.join( ' ' )}"
+				err.puts setup_parser
+				return { command: :invalid }
+			end
+			{ command: "setup", cli_choices: options }
+		rescue OptionParser::ParseError => e
+			err.puts "#{BADGE} #{e.message}"
+			{ command: :invalid }
+		end
+
 		def self.parse_repo_path_command( command:, argv:, parser:, err: )
 			parser.parse!( argv )
 			if argv.length > 1
@@ -209,7 +233,7 @@ module Carson
 
 			case command
 			when "setup"
-				runtime.setup!
+				runtime.setup!( cli_choices: parsed.fetch( :cli_choices, {} ) )
 			when "audit"
 				runtime.audit!
 			when "sync"

data/lib/carson/runtime/setup.rb

@@ -6,13 +6,17 @@ module Carson
 		module Setup
 			WELL_KNOWN_REMOTES = %w[origin github upstream].freeze
 
-			def setup!
+			def setup!( cli_choices: {} )
 				puts_verbose ""
 				puts_verbose "[Setup]"
 
 				unless inside_git_work_tree?
 					puts_line "WARN: not a git repository. Skipping remote and branch detection."
-					return write_setup_config( choices: {} )
+					return write_setup_config( choices: cli_choices )
+				end
+
+				unless cli_choices.empty?
+					return write_setup_config( choices: cli_choices )
 				end
 
 				if self.in.respond_to?( :tty? ) && self.in.tty?

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: carson
 version: !ruby/object:Gem::Version
-  version: 2.27.0
+  version: 2.28.0
 platform: ruby
 authors:
 - Hailei Wang