carson 2.24.0 → 2.25.0

data/lib/carson/runtime/review/gate_support.rb

@@ -167,7 +167,7 @@ module Carson
 
 				# Writes review gate artefacts using fixed report names in global report output.
 				def write_review_gate_report( report: )
-					markdown_path, json_path = write_report(
+					markdown_path, json_path = report(
 						report: report,
 						markdown_name: REVIEW_GATE_REPORT_MD,
 						json_name: REVIEW_GATE_REPORT_JSON,

data/lib/carson/runtime/review/sweep_support.rb

@@ -199,7 +199,7 @@ module Carson
 
 				# Writes sweep artefacts for CI logs and local troubleshooting.
 				def write_review_sweep_report( report: )
-					markdown_path, json_path = write_report(
+					markdown_path, json_path = report(
 						report: report,
 						markdown_name: REVIEW_SWEEP_REPORT_MD,
 						json_name: REVIEW_SWEEP_REPORT_JSON,

data/lib/carson/runtime/review/utility.rb

@@ -14,7 +14,7 @@ module Carson
 
 				# Disposition records always start with configured prefix.
 				def disposition_prefixed?( text: )
-					text.to_s.lstrip.start_with?( config.review_disposition_prefix )
+					text.to_s.lstrip.start_with?( config.review_disposition )
 				end
 
 				# Extracts first matching disposition token from configured acknowledgement body.
@@ -48,7 +48,7 @@ module Carson
 				end
 
 				# Shared report writer for JSON plus Markdown pairs in global report output.
-				def write_report( report:, markdown_name:, json_name:, renderer: )
+				def report( report:, markdown_name:, json_name:, renderer: )
 					report_dir = report_dir_path
 					FileUtils.mkdir_p( report_dir )
 					markdown_path = File.join( report_dir, markdown_name )

data/lib/carson/runtime/setup.rb

@@ -127,22 +127,28 @@ module Carson
 			def prompt_workflow_style
 				puts_line ""
 				puts_line "Workflow style"
+				current = config.workflow_style
+				puts_line "  Currently: #{current}" unless current.nil? || current.empty?
 				options = [
 					{ label: "branch — enforce PR-only merges (default)", value: "branch" },
 					{ label: "trunk — commit directly to main", value: "trunk" }
 				]
-				prompt_choice( options: options, default: 0 )
+				default_index = options.index { |o| o.fetch( :value ) == current } || 0
+				prompt_choice( options: options, default: default_index )
 			end
 
 			def prompt_merge_method
 				puts_line ""
 				puts_line "Merge method"
+				current = config.govern_merge_method
+				puts_line "  Currently: #{current}" unless current.nil? || current.empty?
 				options = [
 					{ label: "squash — one commit per PR (recommended)", value: "squash" },
 					{ label: "rebase — linear history, individual commits", value: "rebase" },
 					{ label: "merge — merge commits", value: "merge" }
 				]
-				prompt_choice( options: options, default: 0 )
+				default_index = options.index { |o| o.fetch( :value ) == current } || 0
+				prompt_choice( options: options, default: default_index )
 			end
 
 			def prompt_canonical_template

data/lib/carson/runtime.rb

@@ -216,7 +216,6 @@ module Carson
 end
 
 require_relative "runtime/local"
-require_relative "runtime/lint"
 require_relative "runtime/audit"
 require_relative "runtime/review"
 require_relative "runtime/govern"

data/templates/.github/carson.md

@@ -24,7 +24,6 @@ carson review gate     # block until actionable review findings are resolved
 ```bash
 carson sync            # fast-forward local main from remote
 carson prune           # remove stale branches (safer than git branch -d on squash repos)
-carson housekeep       # sync + prune together
 ```
 
 ## Exit Codes

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: carson
 version: !ruby/object:Gem::Version
-  version: 2.24.0
+  version: 2.25.0
 platform: ruby
 authors:
 - Hailei Wang
@@ -53,8 +53,12 @@ files:
 - lib/carson/runtime.rb
 - lib/carson/runtime/audit.rb
 - lib/carson/runtime/govern.rb
-- lib/carson/runtime/lint.rb
 - lib/carson/runtime/local.rb
+- lib/carson/runtime/local/hooks.rb
+- lib/carson/runtime/local/onboard.rb
+- lib/carson/runtime/local/prune.rb
+- lib/carson/runtime/local/sync.rb
+- lib/carson/runtime/local/template.rb
 - lib/carson/runtime/review.rb
 - lib/carson/runtime/review/data_access.rb
 - lib/carson/runtime/review/gate_support.rb

data/lib/carson/runtime/lint.rb

@@ -1,154 +0,0 @@
-require "fileutils"
-require "open3"
-require "tmpdir"
-
-module Carson
-	class Runtime
-		module Lint
-			# Distributes lint policy files from a central source into the governed repository.
-			# Target: <repo>/.github/linters/ (MegaLinter auto-discovers here).
-			def lint_setup!( source:, ref: "main", force: false, **_ )
-				puts_verbose ""
-				puts_verbose "[Lint Policy]"
-				source_text = source.to_s.strip
-				if source_text.empty?
-					puts_line "ERROR: lint policy requires --source <path-or-git-url>."
-					return EXIT_ERROR
-				end
-
-				ref_text = ref.to_s.strip
-				ref_text = "main" if ref_text.empty?
-				source_dir, cleanup = lint_setup_source_directory( source: source_text, ref: ref_text )
-				begin
-					target_dir = repo_linters_dir
-					copy_result = copy_lint_policy_files(
-						source_dir: source_dir,
-						target_dir: target_dir,
-						force: force
-					)
-					puts_verbose "lint_policy_source: #{source_text}"
-					puts_verbose "lint_policy_ref: #{ref_text}" if lint_source_git_url?( source: source_text )
-					puts_verbose "lint_policy_target: #{target_dir}"
-					puts_verbose "lint_policy_created: #{copy_result.fetch( :created )}"
-					puts_verbose "lint_policy_updated: #{copy_result.fetch( :updated )}"
-					puts_verbose "lint_policy_skipped: #{copy_result.fetch( :skipped )}"
-
-					puts_line "OK: lint policy synced to .github/linters/ (#{copy_result.fetch( :created )} created, #{copy_result.fetch( :updated )} updated)."
-					EXIT_OK
-				ensure
-					cleanup&.call
-				end
-			rescue StandardError => e
-				puts_line "ERROR: lint policy failed (#{e.message})"
-				EXIT_ERROR
-			end
-
-		private
-			def lint_setup_source_directory( source:, ref: )
-				if lint_source_git_url?( source: source )
-					return lint_setup_clone_source( source: source, ref: ref )
-				end
-
-				expanded_source = File.expand_path( source )
-				raise "source path does not exist: #{expanded_source}" unless Dir.exist?( expanded_source )
-				[ expanded_source, nil ]
-			end
-
-			def lint_source_git_url?( source: )
-				text = source.to_s.strip
-				text.start_with?( "https://", "http://", "ssh://", "git@", "file://" )
-			end
-
-			def lint_setup_clone_source( source:, ref: )
-				cache_root = cache_workspace_root
-				FileUtils.mkdir_p( cache_root )
-				work_dir = Dir.mktmpdir( "carson-lint-setup-", cache_root )
-				checkout_dir = File.join( work_dir, "source" )
-				clone_source = authenticated_lint_source( source: source )
-				stdout_text, stderr_text, status = Open3.capture3(
-					"git", "clone", "--depth", "1", "--branch", ref, clone_source, checkout_dir
-				)
-				unless status.success?
-					error_text = [ stderr_text.to_s.strip, stdout_text.to_s.strip ].reject( &:empty? ).join( " | " )
-					error_text = "git clone failed" if error_text.empty?
-					raise "unable to clone lint source #{safe_lint_source( source: source )} (#{error_text})"
-				end
-				[ checkout_dir, -> { FileUtils.rm_rf( work_dir ) } ]
-			end
-
-			def authenticated_lint_source( source: )
-				token = ENV.fetch( "CARSON_READ_TOKEN", "" ).to_s.strip
-				return source if token.empty?
-
-				return source unless source.start_with?( "https://github.com/", "http://github.com/", "git@github.com:" )
-
-				if source.start_with?( "git@github.com:" )
-					path = source.sub( "git@github.com:", "" )
-					return "https://x-access-token:#{token}@github.com/#{path}"
-				end
-
-				source.sub( %r{\Ahttps?://github\.com/}, "https://x-access-token:#{token}@github.com/" )
-			end
-
-			def safe_lint_source( source: )
-				source.to_s.gsub( %r{https://[^@]+@}, "https://***@" )
-			end
-
-			def cache_workspace_root
-				home = ENV.fetch( "HOME", "" ).to_s.strip
-				if home.start_with?( "/" )
-					path = File.join( home, ".carson", "cache" )
-					FileUtils.mkdir_p( path )
-					return path
-				end
-				"/tmp/carson"
-			rescue StandardError
-				"/tmp/carson"
-			end
-
-			# Lint configs live inside the governed repository for MegaLinter.
-			def repo_linters_dir
-				File.join( repo_root, ".github", "linters" )
-			end
-
-			def copy_lint_policy_files( source_dir:, target_dir:, force: )
-				FileUtils.mkdir_p( target_dir )
-				created = 0
-				updated = 0
-				skipped = 0
-				Dir.glob( "**/*", File::FNM_DOTMATCH, base: source_dir ).sort.each do |relative|
-					next if [ ".", ".." ].include?( relative )
-					next if relative.start_with?( ".git/" ) || relative == ".git"
-					source_path = File.join( source_dir, relative )
-					target_path = File.join( target_dir, relative )
-					if File.directory?( source_path )
-						FileUtils.mkdir_p( target_path )
-						next
-					end
-					next unless File.file?( source_path )
-
-					if File.exist?( target_path ) && !force
-						skipped += 1
-						next
-					end
-					target_exists = File.exist?( target_path )
-					FileUtils.mkdir_p( File.dirname( target_path ) )
-					FileUtils.cp( source_path, target_path )
-					FileUtils.chmod( File.stat( source_path ).mode & 0o777, target_path )
-					if target_exists
-						updated += 1
-					else
-						created += 1
-					end
-				end
-				{
-					created: created,
-					updated: updated,
-					skipped: skipped
-				}
-			end
-		end
-
-		include Lint
-	end
-end