carson 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,12 @@
1
+ ## Shared Governance Baseline
2
+
3
+ - GitHub rulesets and required checks are merge authority.
4
+ - Carson runs as an outsider runtime for hook health, main sync, scope integrity, and gh visibility.
5
+ - Before commit and before push, run `carson audit`.
6
+ - At session start and again immediately before merge recommendation, run `gh pr list --state open --limit 50` and re-confirm active PR priorities.
7
+ - Before merge recommendation, run `carson review gate`; it enforces warm-up wait, unresolved-thread convergence, and `Disposition:` dispositions for actionable top-level findings.
8
+ - Actionable findings are unresolved review threads, any non-author `CHANGES_REQUESTED` review, or non-author comments/reviews with risk keywords (`bug`, `security`, `incorrect`, `block`, `fail`, `regression`).
9
+ - `Disposition:` dispositions must include one token (`accepted`, `rejected`, `deferred`) and the target review URL.
10
+ - Scheduled governance runs `carson review sweep` every 8 hours to track late actionable review activity on recent open/closed PRs.
11
+ - Do not treat green checks or `mergeStateStatus: CLEAN` as sufficient if unresolved review threads remain.
12
+ - Never suggest destructive operations on protected refs (`main`/`master`, local or remote).
@@ -0,0 +1,14 @@
1
+ ## Shared Scope and Validation
2
+
3
+ - [ ] `single_business_intent`: this PR is one coherent domain or feature intent.
4
+ - [ ] `single_scope_group`: non-doc files stay within one scope group.
5
+ - [ ] `cross-boundary_changes_justified`: any cross-boundary change has explicit rationale.
6
+ - [ ] `carson audit` before commit.
7
+ - [ ] `carson audit` before push.
8
+ - [ ] `gh pr list --state open --limit 50` checked at session start (capture competing active PRs).
9
+ - [ ] `gh pr list --state open --limit 50` re-checked immediately before merge decision.
10
+ - [ ] Required CI checks are passing.
11
+ - [ ] At least 60 seconds passed since the last push to allow AI reviewers to post.
12
+ - [ ] No unresolved required conversation threads at merge time.
13
+ - [ ] `carson review gate` passes with converged snapshots.
14
+ - [ ] Every actionable top-level review item has a `Disposition:` disposition (`accepted`, `rejected`, `deferred`) with the target review URL.
metadata ADDED
@@ -0,0 +1,80 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: carson
3
+ version: !ruby/object:Gem::Version
4
+ version: 1.0.0
5
+ platform: ruby
6
+ authors:
7
+ - Hailei Wang
8
+ bindir: exe
9
+ cert_chain: []
10
+ date: 1980-01-02 00:00:00.000000000 Z
11
+ dependencies: []
12
+ description: Carson runs outside host repositories and applies governance checks,
13
+ review gates, and managed GitHub-native files.
14
+ email:
15
+ - wanghailei@users.noreply.github.com
16
+ executables:
17
+ - carson
18
+ extensions: []
19
+ extra_rdoc_files: []
20
+ files:
21
+ - ".github/copilot-instructions.md"
22
+ - ".github/pull_request_template.md"
23
+ - ".github/workflows/carson_policy.yml"
24
+ - API.md
25
+ - LICENSE
26
+ - MANUAL.md
27
+ - README.md
28
+ - RELEASE.md
29
+ - VERSION
30
+ - assets/hooks/pre-commit
31
+ - assets/hooks/pre-merge-commit
32
+ - assets/hooks/pre-push
33
+ - assets/hooks/prepare-commit-msg
34
+ - carson.gemspec
35
+ - exe/carson
36
+ - lib/carson.rb
37
+ - lib/carson/adapters/git.rb
38
+ - lib/carson/adapters/github.rb
39
+ - lib/carson/cli.rb
40
+ - lib/carson/config.rb
41
+ - lib/carson/policy/ruby/lint.rb
42
+ - lib/carson/runtime.rb
43
+ - lib/carson/runtime/audit.rb
44
+ - lib/carson/runtime/lint.rb
45
+ - lib/carson/runtime/local.rb
46
+ - lib/carson/runtime/review.rb
47
+ - lib/carson/runtime/review/data_access.rb
48
+ - lib/carson/runtime/review/gate_support.rb
49
+ - lib/carson/runtime/review/query_text.rb
50
+ - lib/carson/runtime/review/sweep_support.rb
51
+ - lib/carson/runtime/review/utility.rb
52
+ - lib/carson/version.rb
53
+ - templates/.github/copilot-instructions.md
54
+ - templates/.github/pull_request_template.md
55
+ homepage: https://github.com/wanghailei/carson
56
+ licenses:
57
+ - MIT
58
+ metadata:
59
+ source_code_uri: https://github.com/wanghailei/carson
60
+ changelog_uri: https://github.com/wanghailei/carson/blob/main/RELEASE.md
61
+ bug_tracker_uri: https://github.com/wanghailei/carson/issues
62
+ documentation_uri: https://github.com/wanghailei/carson/blob/main/MANUAL.md
63
+ rdoc_options: []
64
+ require_paths:
65
+ - lib
66
+ required_ruby_version: !ruby/object:Gem::Requirement
67
+ requirements:
68
+ - - ">="
69
+ - !ruby/object:Gem::Version
70
+ version: '4.0'
71
+ required_rubygems_version: !ruby/object:Gem::Requirement
72
+ requirements:
73
+ - - ">="
74
+ - !ruby/object:Gem::Version
75
+ version: '0'
76
+ requirements: []
77
+ rubygems_version: 4.0.3
78
+ specification_version: 4
79
+ summary: Outsider governance runtime for repository hygiene and merge readiness.
80
+ test_files: []