carson 3.29.0 → 3.29.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9d026cfc1581b568aaa9459ab21faf0d4f52d1026995b5ce62f21dca0072853a
-  data.tar.gz: '08bdaaebab6ccaf1dac6768057f55acf3833ddbe903001b2ca3934551f280bae'
+  metadata.gz: bdb70b55b0dddf63dd2e96b68d060472e3abfd10ae6c55010df2d43ad766c7b8
+  data.tar.gz: 122ef3005263475ce82fce1177037ddd4f017662a5a74bbee16ada7a464e0fc6
 SHA512:
-  metadata.gz: 68d7fd88800a7a2756466ae88e3be1baae2df66b25d285cd54b676b6506d1ee86c69a110bf4f040c8259fc9dc8aa623120b0150b4a73c3081460c080940bfb2b
-  data.tar.gz: 35403e45bad7632031bbc9c56a8aece6e7b3dc7eafa1c36c4f183bc7c6271beb1b39d4b35985373cb9be0baee3b8cc58491920bb2f63dcf852fb20c4198c33ed
+  metadata.gz: f526c974bf821f31a025e5a7c2a09644d3ef814c04f62a5d7021c0c6d102a9a883320c16ab20ab559159a95eee0198a26dfdec37c5684fd09936a13cbd7d081e
+  data.tar.gz: 6e7b04be1bf3a96d607599af821f38b4fb9cbaadea9c54f69407bf5d5d90bd4f10b46eec1e9254b4bbc6f1fa0c3e3bd673e9be8343a3b6e4006fe3a3291b8913

data/RELEASE.md

@@ -5,6 +5,16 @@ 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`.
 
+## 3.29.1
+
+### What changed
+
+- **Delivery output now shows the remote target explicitly** — `Delivery: branch → github/main` instead of the ambiguous `→ main`, making it clear the target is the remote branch, not local.
+
+### No migration required
+
+- Existing workflows continue to work unchanged.
+
 ## 3.29.0
 
 ### What changed

data/VERSION

@@ -1 +1 @@
-3.29.0
+3.29.1

data/carson.gemspec

@@ -37,7 +37,6 @@ Gem::Specification.new do |spec|
 		"RELEASE.md",
 		"VERSION",
 		"LICENSE",
-		"SKILL.md",
 		"icon.svg",
 		"carson.gemspec"
 	]

data/lib/carson/runtime/deliver.rb

@@ -16,6 +16,7 @@ module Carson
 				result = {
 					command: "deliver",
 					branch: branch_name,
+					git_remote: remote_name,
 					watch_window_seconds: config.govern_check_wait.to_i,
 					waited_seconds: 0,
 					merge_attempted: false
@@ -948,8 +949,10 @@ module Carson
 
 				if result[ :delivery ]
 					branch = result[ :branch ]
+					remote = result[ :git_remote ] || "github"
 					main = result[ :main_branch ] || "main"
-					puts_line "Delivery: #{branch} → #{main}"
+					remote_main = "#{remote}/#{main}"
+					puts_line "Delivery: #{branch} → #{remote_main}"
 				end
 				if result[ :commit ]
 					puts_line "Committed: #{result.dig( :commit, :summary )}"
@@ -961,9 +964,9 @@ module Carson
 					summary = result[ :summary ]
 					if outcome == "integrated" || status == "integrated"
 						if result[ :merge_method ]
-							puts_line "Merged into #{main} with #{result[ :merge_method ]}."
+							puts_line "Merged into #{remote_main} with #{result[ :merge_method ]}."
 						else
-							puts_line "Merged into #{main}."
+							puts_line "Merged into #{remote_main}."
 						end
 						if result[ :synced ] == false
 							puts_line "Local #{main} sync failed — #{result[ :sync_error ]}."

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: carson
 version: !ruby/object:Gem::Version
-  version: 3.29.0
+  version: 3.29.1
 platform: ruby
 authors:
 - Hailei Wang
@@ -51,7 +51,6 @@ files:
 - MANUAL.md
 - README.md
 - RELEASE.md
-- SKILL.md
 - VERSION
 - carson.gemspec
 - exe/carson

data/SKILL.md

@@ -1,99 +0,0 @@
-# Carson Skill
-
-You are working in a repository governed by Carson — an autonomous git strategist and repositories governor. Carson handles git hooks, PR triage, agent dispatch, merge, and cleanup. You provide the intelligence; Carson provides the infrastructure.
-
-## When to use Carson commands
-
-| User intent | Command | What happens |
-|---|---|---|
-| "Check if my code is ready" | `carson audit` | Scope, boundary checks. Exit 0 = clean. Exit 2 = policy block. |
-| "Is my PR mergeable?" | `carson review gate` | Polls for unresolved review threads and actionable comments. Blocks until resolved. |
-| "What's happening across my repos?" | `carson govern --dry-run` | Classifies every open PR without taking action. Read the summary. |
-| "Run governance continuously" | `carson govern --loop 300` | Triage-dispatch-merge cycle every 300 seconds. Ctrl-C to stop. |
-| "Merge ready PRs and dispatch fixes" | `carson govern` | Full autonomous cycle: merge, dispatch agents, escalate. |
-| "Set up Carson for a repo" | `carson onboard /path/to/repo` | Installs hooks, syncs templates, runs first audit. |
-| "Refresh after upgrading Carson" | `carson refresh` | Re-applies hooks and templates for the current version. |
-| "Update my local main" | `carson sync` | Fast-forward local main from remote. Blocks if tree is dirty. |
-| "Clean up stale branches" | `carson prune` | Removes local branches whose upstream is gone. |
-| "Check template drift" | `carson template check` then `carson template apply` | Detect and fix .github/* drift. |
-| "Remove Carson from a repo" | `carson offboard /path/to/repo` | Removes hooks and managed files. |
-| "What version?" | `carson version` | Prints installed version with ⧓ badge. |
-
-## Exit codes
-
-- `0` — success, all clear.
-- `1` — runtime or configuration error. Read the error message.
-- `2` — policy block. Something must be fixed before proceeding (unresolved review, boundary breach).
-
-When you see exit 2, do NOT bypass it. Read the output, fix the root cause, and re-run.
-
-## Interpreting audit output
-
-Carson audit output is structured as labelled key-value lines prefixed with ⧓. Key sections:
-
-- **Working Tree** — staged/unstaged status.
-- **Main Sync Status** — whether local main matches remote. If ahead, reset drift before committing.
-- **Scope Integrity Guard** — checks that commits stay within a single business intent and scope group.
-- **Audit Result** — final verdict: `status: ok` (clean), `status: attention` (advisory, not blocking), `status: block` (must fix).
-
-## Interpreting govern output
-
-`carson govern --dry-run` classifies each PR:
-
-- **ready** → would merge. All gates pass.
-- **ci_failing** → would dispatch agent to fix CI.
-- **review_blocked** → would dispatch agent to address review comments.
-- **pending** → skip. Checks still running (within check_wait window).
-- **needs_attention** → escalate. Needs human judgement.
-
-The summary line: `govern_summary: repos=N prs=N ready=N blocked=N`
-
-## Configuration
-
-Single config file: `~/.carson/config.json`. Key settings:
-
-```json
-{
-  "govern": {
-    "repos": ["~/Dev/repo-a", "~/Dev/repo-b"],
-    "merge": { "method": "rebase" },
-    "agent": { "provider": "auto" }
-  },
-  "review": {
-    "bot_usernames": ["gemini-code-assist"]
-  }
-}
-```
-
-- `govern.merge.method` — must match GitHub branch protection. Use `rebase` if linear history is required.
-- `govern.repos` — list of repo paths for portfolio-level governance. Empty = current repo only.
-- `govern.agent.provider` — `auto` (tries codex then claude), `codex`, or `claude`.
-- `review.bot_usernames` — bot logins to ignore in review gate. Use GraphQL login format (no `[bot]` suffix).
-
-Environment overrides take precedence over config file. Common ones:
-- `CARSON_GOVERN_MERGE_METHOD`
-- `CARSON_REVIEW_BOT_USERNAMES`
-- `CARSON_GOVERN_CHECK_WAIT`
-
-## Common scenarios
-
-**Commit blocked by audit:**
-Run `carson audit`, read the block reason, fix it, then `git add` and `git commit` again. Do not skip the hook.
-
-**Review gate blocked:**
-Run `carson review gate` to see which comments need disposition. Respond to each with the required prefix (default: `Disposition:`), then re-run.
-
-**Local main drifted ahead of remote:**
-This means a commit was made to main that couldn't be pushed (branch protection). Reset: `git checkout main && git reset --hard github/main`.
-
-**Hooks out of date after upgrade:**
-Run `carson refresh` to re-apply hooks and templates for the current version.
-
-**Govern merge fails:**
-Check that `govern.merge.method` in config matches what GitHub allows. If the repo enforces linear history, only `rebase` works.
-
-## Boundaries
-
-- Carson never lives inside governed repositories. No `.carson.yml`, no `bin/carson`, no `.tools/carson/`.
-- Carson-managed files in repos are limited to `.github/*` templates.
-- Carson's hooks live at `~/.carson/hooks/<version>/`, never in `.git/hooks/`.