carson 1.0.0 → 2.6.0

data/RELEASE.md

@@ -5,6 +5,350 @@ 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.6.0 — Default Squash Merge + Agent Discovery Templates
+
+### What changed
+
+- **Default merge method changed from `merge` to `squash`.** Squash-to-main keeps history linear: one PR = one commit on main. Every commit on main corresponds to a reviewed, CI-passing unit of work and is individually revertable. This aligns Carson's built-in default with how most teams should run.
+- **Agent discovery via managed templates.** Interactive agents (Claude Code, Codex, Copilot) working in Carson-governed repos now discover Carson automatically. A new source-of-truth file `.github/carson-instructions.md` contains the full governance baseline. Agent-specific files (`.github/CLAUDE.md`, `.github/AGENTS.md`, `.github/copilot-instructions.md`) are one-line pointers to it. Zero drift risk — one file to maintain, all agents follow the same reference.
+- **Managed template set expanded.** `carson template apply` now writes five files: `carson-instructions.md`, `copilot-instructions.md`, `CLAUDE.md`, `AGENTS.md`, and `pull_request_template.md`.
+
+### What users must do now
+
+1. Upgrade Carson to `2.6.0`.
+2. Run `carson prepare` in each governed repository.
+3. Run `carson template apply` to write the new managed files.
+4. Commit the new `.github/*` files.
+5. If you previously set `govern.merge.method` to `"merge"` explicitly in `~/.carson/config.json`, review whether `"squash"` (now the default) is the right choice.
+
+### Breaking or removed behaviour
+
+- `govern.merge.method` default changed from `merge` to `squash`. If your GitHub repository only allows merge commits, set `"govern": { "merge": { "method": "merge" } }` in `~/.carson/config.json`.
+- `.github/copilot-instructions.md` content replaced with a one-line reference. The governance baseline now lives in `.github/carson-instructions.md`.
+
+### Upgrade steps
+
+```bash
+cd ~/Dev/carson
+git pull
+bash install.sh
+carson version
+carson prepare
+carson template apply
+```
+
+### Engineering Appendix
+
+#### Modified components
+
+- `lib/carson/config.rb` — `govern.merge.method` default changed from `"merge"` to `"squash"`; `template.managed_files` expanded to include `carson-instructions.md`, `CLAUDE.md`, and `AGENTS.md`.
+- `script/ci_smoke.sh` — offboard removal check updated for new managed files.
+- `test/runtime_govern_test.rb` — unit test updated for squash default.
+
+#### New files
+
+- `templates/.github/carson-instructions.md` — governance baseline source of truth.
+- `templates/.github/CLAUDE.md` — one-line reference for Claude Code.
+- `templates/.github/AGENTS.md` — one-line reference for Codex.
+
+#### Changed files
+
+- `templates/.github/copilot-instructions.md` — replaced full content with one-line reference.
+
+#### Public interface and config changes
+
+- `govern.merge.method` default: `"merge"` → `"squash"`.
+- `template.managed_files` default expanded from 2 to 5 files.
+- Exit status contract unchanged.
+
+#### Verification evidence
+
+- CI passes on PRs #77 and #78.
+
+---
+
+## 2.4.0 — Agent Skill Injection + Scope Guard Reform
+
+### What changed
+
+- **SKILL.md injected into agent prompts.** Carson now embeds the full SKILL.md content into every dispatched agent work order. Codex and Claude receive Carson governance knowledge without any files inside the governed repository — the outsider principle holds.
+- **SKILL.md added.** A new agent interface document covering commands, exit codes, output interpretation, config, and common scenarios. Ships with the gem.
+- **Scope integrity guard is advisory only.** The cross-boundary check no longer blocks commits. Commits should be grouped by feature intent, not file type. The scope guard still prints diagnostics but never prevents a commit.
+- **App icon.** Added `icon.svg` (⧓ black bowtie mark) with centered display in README.
+- **Hooks moved to repo root.** `assets/hooks/` → `hooks/`. The `assets/` directory is removed.
+
+### What users must do now
+
+1. Upgrade Carson to `2.4.0`.
+2. Run `carson prepare` in each governed repository.
+
+### Breaking or removed behaviour
+
+- Scope integrity guard no longer hard-blocks commits with multiple core module groups. If you relied on this as a gate, it is now advisory only.
+- `assets/` directory removed. Hook templates now live at `hooks/` in the gem root.
+
+### Upgrade steps
+
+```bash
+cd ~/Dev/carson
+git pull
+bash install.sh
+carson version
+carson prepare
+carson govern --dry-run
+```
+
+### Engineering Appendix
+
+#### Modified components
+
+- `lib/carson/adapters/prompt.rb` — reads SKILL.md at build time and wraps it in `<carson_skill>` XML tags in the agent prompt.
+- `lib/carson/runtime/audit.rb` — removed `split_required` hard-block escalation; scope guard status capped at `attention`.
+- `lib/carson/runtime/local.rb` — hook template path updated from `assets/hooks` to `hooks`.
+- `lib/carson/config.rb` — scope path updated from `assets/hooks/**` to `hooks/**`.
+- `carson.gemspec` — glob updated, `SKILL.md` and `icon.svg` added to files list.
+- `script/ci_smoke.sh` — scope guard smoke test expects advisory exit instead of block.
+
+#### New files
+
+- `SKILL.md` — agent interface document, shipped with the gem.
+- `icon.svg` — app icon.
+
+#### Public interface and config changes
+
+- No new CLI commands or config keys.
+- Exit status contract unchanged.
+
+#### Verification evidence
+
+- All CI checks pass across PRs #70–#73.
+
+---
+
+## 2.3.0 — Continuous Govern Loop + Brand Badge
+
+### What changed
+
+- Command renames: `init` → `onboard`, `check` → `inspect`, `hook` → `prepare`.
+- Configurable workflow style (`trunk` or `branch`) with hook enforcement.
+- Review gate UX improvements: bot-aware filtering, warmup wait, convergence polling.
+- `carson govern --loop SECONDS` — run the govern cycle continuously with built-in sleep loop. Per-cycle error isolation keeps the daemon alive through transient failures. `Ctrl-C` exits cleanly with a cycle count summary.
+
+### What users must do now
+
+1. Upgrade Carson to `2.3.0`.
+2. Run `carson refresh` in each governed repository to update hooks for the new command names.
+3. Optionally use `carson govern --loop 300` for unattended continuous governance.
+
+### Breaking or removed behaviour
+
+- Commands `init`, `check`, and `hook` have been renamed to `onboard`, `inspect`, and `prepare` respectively.
+
+### Upgrade steps
+
+```bash
+cd ~/Dev/carson
+git pull
+bash install.sh
+carson version
+carson refresh ~/Dev/your-project
+carson govern --dry-run
+```
+
+### Engineering Appendix
+
+#### Modified components
+
+- `lib/carson/cli.rb` — added `--loop SECONDS` to govern parser, banner, and dispatch.
+- `lib/carson/runtime/govern.rb` — extracted `govern_cycle!`, added `govern_loop!` with per-cycle error isolation and `Interrupt` handling.
+
+#### Public interface and config changes
+
+- Added CLI flag: `--loop SECONDS` for `carson govern`.
+- No new config keys. The loop interval is a runtime argument, not a persistent preference.
+- Exit status contract unchanged.
+
+#### Verification evidence
+
+- All govern unit tests pass including 4 new loop CLI tests.
+
+---
+
+## 2.1.0 — Enriched Agent Work Orders
+
+### What changed
+
+- Agent work orders now include structured evidence instead of just the PR title. Before dispatching a coding agent, Carson gathers CI failure logs or review comment bodies and includes them in the work order so the agent can act on real context.
+- Configurable check wait (`govern.check_wait`, default 30 seconds). When PR checks are still pending and the PR was recently updated, Carson skips it instead of prematurely dispatching a fix — giving GitHub bots and CI time to post results.
+- Shared prompt module extracted from Codex/Claude adapters. Both adapters now use `Adapters::Prompt` with structured XML context tags.
+- Developer documentation updated with an ASCII flow diagram of the autonomous governance loop.
+
+### Evidence gathering detail
+
+- `fix_ci` objectives: Carson fetches the most recent failed CI run via `gh run list --status failure`, then retrieves failure logs via `gh run view --log-failed`. The tail of the log (up to 8,000 chars) is included in the work order.
+- `address_review` objectives: Carson fetches unresolved review threads and actionable top-level findings via GraphQL, and includes each finding's body text (up to 2,000 chars each).
+- Re-dispatch: if a prior dispatch for the same PR failed, the previous attempt summary is included so the agent can avoid repeating the same approach.
+- Graceful degradation: if evidence gathering fails, the agent receives the PR title and is told to investigate locally.
+
+### What users must do now
+
+1. Upgrade Carson to `2.1.0`.
+2. Optionally tune `govern.check_wait` in `~/.carson/config.json` or via `CARSON_GOVERN_CHECK_WAIT`.
+
+### Breaking or removed behaviour
+
+- None. The `context` field on `WorkOrder` is backward compatible — String values are still accepted.
+
+### Upgrade steps
+
+```bash
+cd ~/Dev/carson
+git pull
+bash install.sh
+carson version
+carson govern --dry-run
+```
+
+### Engineering Appendix
+
+#### New components
+
+- `lib/carson/adapters/prompt.rb` — shared prompt builder module with structured XML context tags.
+
+#### Modified components
+
+- `lib/carson/runtime/govern.rb` — evidence methods (`evidence`, `ci_evidence`, `review_evidence`, `prior_attempt`, `truncate_log`), check wait logic (`within_check_wait?`, `TRIAGE_PENDING`), `updatedAt` added to `gh pr list` fields.
+- `lib/carson/config.rb` — added `govern.check_wait` (integer, seconds, default 30).
+- `lib/carson/adapters/codex.rb`, `lib/carson/adapters/claude.rb` — now include `Prompt` module, removed duplicate `build_prompt`/`sanitize`.
+- `lib/carson/adapters/agent.rb` — updated `context` field documentation for Hash shapes.
+- `docs/develop.md` — added autonomous governance loop section with ASCII diagram.
+
+#### Public interface and config changes
+
+- Added config key: `govern.check_wait` (integer, seconds, default 30).
+- Added env override: `CARSON_GOVERN_CHECK_WAIT`.
+- Exit status contract unchanged.
+
+#### Verification evidence
+
+- 37 govern unit tests pass (18 new, 0 regressions).
+- CI smoke tests pass.
+
+---
+
+## 2.0.0 — Autonomous Governance
+
+### Architectural shift
+
+Carson 2.0.0 is an architectural change. Prior versions were a passive governance tool: Carson checked, reported, and blocked — but you still had to triage PRs, dispatch fixes, click merge, and clean up. Across a portfolio of repositories with coding agents producing many PRs, you were the bottleneck.
+
+Carson is now an autonomous governance runtime. `carson govern` is a portfolio-level triage loop that scans every governed repository, classifies each open PR by CI/review/audit status, and acts: merge what's ready, dispatch a coding agent (Codex or Claude) to fix what's failing, and escalate what needs human judgement. After merging, it housekeeps — syncing main and pruning stale branches.
+
+The per-commit governance (audit, lint, review gate, scope integrity) is unchanged. What's new is the layer above: Carson now orchestrates the full lifecycle from PR to merge to cleanup.
+
+### What changed
+
+- `carson govern [--dry-run] [--json]` — portfolio-level PR triage loop.
+- `carson housekeep` — standalone sync + prune for post-merge cleanup.
+- Agent dispatch adapters for Codex and Claude CLIs, with work-order/result contracts and dispatch state tracking at `~/.carson/govern/dispatch_state.json`.
+- `govern` configuration section: repo list, merge authority/method, agent provider selection.
+- Merge authority is on by default — Carson merges ready PRs autonomously.
+- `.rubocop.yml` removed from repository; lint config now lives at `~/.carson/lint/rubocop.yml` per Carson's own policy.
+
+### What users must do now
+
+1. Upgrade Carson to `2.0.0`.
+2. Run `carson refresh` in each governed repository to update hooks.
+3. Optionally configure `govern.repos` in `~/.carson/config.json` to enable multi-repo portfolio mode.
+4. Run `carson govern --dry-run` to see what Carson would do across your portfolio.
+
+### Breaking or removed behaviour
+
+- `.rubocop.yml` is no longer in the repository. All repos use `~/.carson/lint/rubocop.yml`.
+
+### Upgrade steps
+
+```bash
+cd ~/Dev/carson
+git pull
+bash install.sh
+carson version
+carson refresh ~/Dev/your-project
+carson govern --dry-run
+```
+
+### Engineering Appendix
+
+#### New components
+
+- `lib/carson/runtime/govern.rb` — portfolio triage loop, PR classification, merge, housekeep orchestration.
+- `lib/carson/adapters/agent.rb` — work-order/result data contracts (`WorkOrder`, `Result`).
+- `lib/carson/adapters/codex.rb` — Codex CLI adapter via `Open3.capture3`.
+- `lib/carson/adapters/claude.rb` — Claude CLI adapter via `Open3.capture3`.
+
+#### Decision tree
+
+For each open PR in each governed repo: CI green? Review gate pass? Audit pass? All yes → merge + housekeep. CI failing → dispatch agent. Review blocked → dispatch agent. Other → escalate.
+
+#### Public interface and config changes
+
+- Added CLI commands: `govern [--dry-run] [--json]`, `housekeep`.
+- Added config section: `govern.repos`, `govern.merge.authority` (default: `true`), `govern.merge.method`, `govern.agent.provider`, `govern.dispatch_state_path`.
+- Added env overrides: `CARSON_GOVERN_REPOS`, `CARSON_GOVERN_MERGE_AUTHORITY`, `CARSON_GOVERN_MERGE_METHOD`, `CARSON_GOVERN_AGENT_PROVIDER`.
+- Exit status contract unchanged: `0` OK, `1` runtime/configuration error, `2` policy blocked.
+
+#### Verification evidence
+
+- 87 unit tests pass (19 new govern tests, 0 regressions).
+- 60 smoke tests pass (6 new govern/housekeep tests).
+
+---
+
+## 1.1.0
+
+### User Overview
+
+#### What changed
+
+- All Carson home-directory paths consolidated under `~/.carson/`:
+  - Lint policy files: `~/AI/CODING/` moved to `~/.carson/lint/`.
+  - Audit reports and cache: `~/.cache/carson/` moved to `~/.carson/cache/`.
+  - Launcher symlink: `~/.local/bin/carson` moved to `~/.carson/bin/carson`.
+
+#### Why users should care
+
+- Carson now uses a single top-level directory (`~/.carson/`) for all state. Uninstalling is `rm -rf ~/.carson` plus `gem uninstall carson`.
+- No more scattered paths across `~/.cache`, `~/.local/bin`, and `~/AI`.
+
+#### What users must do now
+
+1. Upgrade Carson to `1.1.0`.
+2. Update PATH: replace `~/.local/bin` with `~/.carson/bin` in your shell profile.
+3. Rerun `carson lint setup --source <path-or-git-url> --force` to populate `~/.carson/lint/`.
+4. Optionally clean up old paths: `rm -rf ~/.cache/carson ~/AI/CODING ~/.local/bin/carson`.
+
+#### Breaking or removed behaviour
+
+- `~/AI/CODING/` is no longer the default lint policy directory.
+- `~/.cache/carson/` is no longer the default report output directory.
+- `~/.local/bin/carson` is no longer the default launcher symlink location.
+- Users with custom `lint.languages` entries in `~/.carson/config.json` pointing to `~/AI/CODING/` must update those paths.
+
+#### Upgrade steps
+
+```bash
+gem install --user-install carson -v 1.1.0
+mkdir -p ~/.carson/bin
+ln -sf "$(ruby -e 'print Gem.user_dir')/bin/carson" ~/.carson/bin/carson
+export PATH="$HOME/.carson/bin:$PATH"
+$HOME/.carson/bin/carson version
+$HOME/.carson/bin/carson lint setup --source /path/to/your-policy-repo --force
+```
+
+Add the `PATH` export to your shell profile so it persists across sessions.
+
+---
+
 ## 1.0.0 (2026-02-25)
 
 ### User Overview
@@ -184,7 +528,7 @@ carson version
 #### What users must do now
 
 1. Upgrade to `0.6.1` where Carson is pinned.
-2. Re-run `carson hook` in governed repositories after upgrade.
+2. Re-run `carson prepare` in governed repositories after upgrade.
 3. Update CI `carson_version` pins to `0.6.1`.
 
 #### Breaking or removed behaviour
@@ -384,7 +728,7 @@ carson version
 #### What users must do now
 
 1. Use `carson offboard /local/path/of/repo` when removing Carson from a repository.
-2. Re-run `carson init /local/path/of/repo` when re-onboarding later.
+2. Re-run `carson onboard /local/path/of/repo` when re-onboarding later.
 
 #### Breaking or removed behaviour
 
@@ -483,7 +827,7 @@ carson version
 
 #### What changed
 
-- Added one-command initialisation: `carson init [repo_path]` (`hook` + `template apply` + `audit`).
+- Added one-command initialisation: `carson onboard [repo_path]` (`hook` + `template apply` + `audit`).
 - Default report output moved to `~/.cache/carson`.
 - Outsider boundary now hard-blocks Carson-owned host artefacts (`.carson.yml`, `bin/carson`, `.tools/carson/*`).
 - Installation/setup guidance now targets standard-user package-consumer flow.
@@ -497,7 +841,7 @@ carson version
 #### What users must do now
 
 1. Install Carson as a normal user executable (`carson` in `PATH`).
-2. Initialise each repository with `carson init /local/path/of/repo`.
+2. Initialise each repository with `carson onboard /local/path/of/repo`.
 3. Remove forbidden Carson-owned artefacts from host repositories if reported.
 4. Read reports from `~/.cache/carson`.
 
@@ -516,7 +860,7 @@ mkdir -p ~/.local/bin
 ln -sf "$(ruby -e 'print Gem.user_dir')/bin/carson" ~/.local/bin/carson
 carson version
 
-carson init /local/path/of/repo
+carson onboard /local/path/of/repo
 carson audit
 ```
 
@@ -538,7 +882,7 @@ carson audit
 
 #### Public interface and config changes
 
-- Command surface is `audit`, `sync`, `prune`, `hook`, `check`, `init`, `template`, `review`, `version`.
+- Command surface is `audit`, `sync`, `prune`, `prepare`, `inspect`, `onboard`, `template`, `review`, `version`.
 - Initialisation command: `init [repo_path]` (no `run` alias).
 - Default report output: `~/.cache/carson`.
 - Exit status contract unchanged: `0` OK, `1` runtime/configuration error, `2` policy block.

data/SKILL.md

@@ -0,0 +1,102 @@
+# Carson Skill
+
+You are working in a repository governed by Carson — a deterministic governance runtime. Carson handles git hooks, lint enforcement, 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` | Lint, 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, housekeep. |
+| "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. |
+| "Verify hook installation" | `carson inspect` | Checks hooks path, file existence, permissions. |
+
+## Exit codes
+
+- `0` — success, all clear.
+- `1` — runtime or configuration error. Read the error message.
+- `2` — policy block. Something must be fixed before proceeding (lint violation, 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.
+- **Local Lint Quality** — per-language lint results. `lint_ruby_status: ok` means clean.
+- **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 prepare` to write new hook versions, then `carson inspect` to verify.
+
+**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/`.
+- Lint policy lives at `~/.carson/lint/`, seeded by `carson lint setup --source <policy-repo>`.

data/VERSION

@@ -1 +1 @@
-1.0.0
+2.6.0

data/carson.gemspec

@@ -22,7 +22,7 @@ Gem::Specification.new do |spec|
 	spec.bindir = "exe"
 	spec.executables = [ "carson" ]
 	spec.require_paths = [ "lib" ]
-	spec.files = Dir.glob( "{lib,exe,templates,assets}/**/*", File::FNM_DOTMATCH ).select { |path| File.file?( path ) } + [
+	spec.files = Dir.glob( "{lib,exe,templates,hooks}/**/*", File::FNM_DOTMATCH ).select { |path| File.file?( path ) } + [
 		".github/copilot-instructions.md",
 		".github/pull_request_template.md",
 		".github/workflows/carson_policy.yml",
@@ -32,6 +32,8 @@ Gem::Specification.new do |spec|
 		"RELEASE.md",
 		"VERSION",
 		"LICENSE",
+		"SKILL.md",
+		"icon.svg",
 		"carson.gemspec"
 	]
 end

data/{assets/hooks → hooks}/pre-commit

@@ -7,7 +7,7 @@ elif command -v carson >/dev/null 2>&1; then
 	carson_command=( "carson" )
 else
 	echo "Carson policy: 'carson' command is required for pre-commit governance checks." >&2
-	echo "Install Carson and rerun 'carson hook'." >&2
+	echo "Install Carson and rerun 'carson prepare'." >&2
 	exit 1
 fi
 

data/{assets/hooks → hooks}/pre-merge-commit

@@ -1,6 +1,10 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
+hooks_dir="$(cd "$(dirname "$0")" && pwd)"
+style="$(cat "$hooks_dir/workflow_style" 2>/dev/null || echo "trunk")"
+[ "$style" = "trunk" ] && exit 0
+
 branch_name="$(git rev-parse --abbrev-ref HEAD)"
 if [[ "$branch_name" == "main" || "$branch_name" == "master" ]]; then
 	echo "Carson policy: direct merge commits on ${branch_name} are blocked. Merge through a pull request." >&2

data/{assets/hooks → hooks}/pre-push

@@ -1,6 +1,10 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
+hooks_dir="$(cd "$(dirname "$0")" && pwd)"
+style="$(cat "$hooks_dir/workflow_style" 2>/dev/null || echo "trunk")"
+[ "$style" = "trunk" ] && exit 0
+
 remote_name="${1:-unknown}"
 remote_url="${2:-unknown}"
 while read -r local_ref local_sha remote_ref remote_sha; do

data/{assets/hooks → hooks}/prepare-commit-msg

@@ -1,6 +1,10 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
+hooks_dir="$(cd "$(dirname "$0")" && pwd)"
+style="$(cat "$hooks_dir/workflow_style" 2>/dev/null || echo "trunk")"
+[ "$style" = "trunk" ] && exit 0
+
 branch_name="$(git rev-parse --abbrev-ref HEAD)"
 if [[ "$branch_name" == "main" || "$branch_name" == "master" ]]; then
 	echo "Carson policy: direct commits on ${branch_name} are blocked. Work on a feature branch and merge via PR." >&2