@onlooker-community/ecosystem 0.32.2 → 0.33.1

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "ecosystem",
-  "version": "0.32.2",
+  "version": "0.33.1",
   "description": "Observability substrate for Claude Code. Provides the shared $ONLOOKER_DIR storage root (default $HOME/.onlooker), canonical schema-validated event emission, session and tool tracking hooks, and prompt rules. Required by all other Onlooker plugins.",
   "author": {
     "name": "Onlooker Community",

package/.release-please-manifest.json

@@ -1,19 +1,19 @@
 {
-  ".": "0.32.2",
+  ".": "0.33.1",
   "plugins/archivist": "0.3.1",
-  "plugins/tribunal": "1.1.1",
+  "plugins/tribunal": "1.1.2",
   "plugins/echo": "0.3.1",
   "plugins/cartographer": "0.3.1",
   "plugins/governor": "0.3.2",
   "plugins/compass": "0.4.1",
-  "plugins/scribe": "0.4.1",
+  "plugins/scribe": "0.4.2",
   "plugins/counsel": "0.5.1",
   "plugins/warden": "0.3.1",
-  "plugins/librarian": "0.6.0",
-  "plugins/curator": "0.2.1",
+  "plugins/librarian": "0.6.1",
+  "plugins/curator": "0.2.2",
   "plugins/historian": "0.3.2",
-  "plugins/assayer": "1.1.1",
-  "plugins/bursar": "0.2.2",
-  "plugins/lineage": "0.2.1",
-  "plugins/inspector": "0.3.1"
+  "plugins/assayer": "1.1.2",
+  "plugins/bursar": "0.3.0",
+  "plugins/lineage": "0.2.2",
+  "plugins/inspector": "0.3.2"
 }

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [0.33.1](https://github.com/onlooker-community/ecosystem/compare/ecosystem-v0.33.0...ecosystem-v0.33.1) (2026-08-02)
+
+
+### Bug Fixes
+
+* restore config convenience functions & refactor execution plugins to shared loader ([#128](https://github.com/onlooker-community/ecosystem/issues/128)) ([4b3660c](https://github.com/onlooker-community/ecosystem/commit/4b3660c5a8b234187ec1e71c37b63e6a3d305c98))
+
+## [0.33.0](https://github.com/onlooker-community/ecosystem/compare/ecosystem-v0.32.2...ecosystem-v0.33.0) (2026-08-02)
+
+
+### Features
+
+* **config:** add shared config loader supporting all five settings layers :sparkles: ([#123](https://github.com/onlooker-community/ecosystem/issues/123)) ([c048b76](https://github.com/onlooker-community/ecosystem/commit/c048b76bee2b39abeb7f1af77181191dd48f9cf5))
+
+
+### Bug Fixes
+
+* **hooks:** prevent SessionEnd timeouts causing breadcrumb accumulation ([#121](https://github.com/onlooker-community/ecosystem/issues/121)) ([3c7a409](https://github.com/onlooker-community/ecosystem/commit/3c7a40937aa3ea8c1db85dd0bb3fcc22589bbb49))
+
 ## [0.32.2](https://github.com/onlooker-community/ecosystem/compare/ecosystem-v0.32.1...ecosystem-v0.32.2) (2026-08-02)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onlooker-community/ecosystem",
-  "version": "0.32.2",
+  "version": "0.33.1",
   "description": "Agents, skills, hooks, commands, rules, and MCP configurations that power [Onlooker](https://onlooker.dev)",
   "author": {
     "name": "Onlooker Community",

package/plugins/archivist/scripts/lib/archivist-config.sh

@@ -1,10 +1,12 @@
 #!/usr/bin/env bash
 # Config resolution for Archivist.
 #
-# Reads three layers, latest wins:
+# Uses the shared config loader from ecosystem. Reads five layers, latest wins:
 #   1. plugins/archivist/config.json (defaults shipped with the plugin)
 #   2. ~/.claude/settings.json
-#   3. <repo>/.claude/settings.json
+#   3. ~/.claude/settings.local.json (local overrides user)
+#   4. <repo>/.claude/settings.json
+#   5. <repo>/.claude/settings.local.json (local overrides project)
 #
 # Exposes:
 #   archivist_config_load <repo_root>    # populates _ARCHIVIST_CONFIG (JSON)
@@ -13,46 +15,20 @@
 # Settings overlay only touches the `archivist.*` subtree of settings.json so it
 # coexists with other plugins' configuration.
 
+# shellcheck source=../../../scripts/lib/config-loader.sh
+source "${PLUGIN_ROOT}/../../scripts/lib/config-loader.sh"
+
 _ARCHIVIST_CONFIG="{}"
 
 archivist_config_load() {
 	local repo_root="${1:-}"
-	local plugin_root="${CLAUDE_PLUGIN_ROOT:-}"
-	local home_dir="${HOME:-}"
-
-	local merged="{}"
-	local file
-
-	file="${plugin_root}/config.json"
-	if [[ -f "$file" ]]; then
-		local defaults
-		defaults=$(jq '.' "$file" 2>/dev/null) || defaults="{}"
-		merged=$(jq -n --argjson a "$merged" --argjson b "$defaults" '$a * $b' 2>/dev/null) \
-			|| merged="$defaults"
-	fi
-
-	for file in "${home_dir}/.claude/settings.json" "${repo_root}/.claude/settings.json"; do
-		[[ -n "$file" && -f "$file" ]] || continue
-		local overlay
-		overlay=$(jq '{ archivist: (.archivist // {}) }' "$file" 2>/dev/null) || continue
-		[[ -z "$overlay" ]] && continue
-		merged=$(jq -n --argjson a "$merged" --argjson b "$overlay" '
-			def deepmerge($a; $b):
-				if ($a|type) == "object" and ($b|type) == "object" then
-					reduce (($a|keys) + ($b|keys) | unique)[] as $k
-						({}; .[$k] = deepmerge($a[$k]; $b[$k]))
-				elif $b == null then $a
-				else $b end;
-			deepmerge($a; $b)
-		' 2>/dev/null) || true
-	done
-
-	_ARCHIVIST_CONFIG="$merged"
+	config_load_plugin "archivist" "$repo_root" "_ARCHIVIST_CONFIG"
+	return 0
 }
 
 # Read a value from the loaded config. Usage:
 #   archivist_config_get '.archivist.injection.max_items'
 archivist_config_get() {
 	local path="$1"
-	printf '%s' "$_ARCHIVIST_CONFIG" | jq -r "${path} // empty" 2>/dev/null
+	config_get "_ARCHIVIST_CONFIG" "${path}"
 }

package/plugins/assayer/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "assayer",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "Claim verification. At session end, parses the agent's final message for testable claims (\"I ran the tests, they pass\", \"the build is green\") and checks each against the actual command results in the session transcript, classifying it corroborated, contradicted, or unverifiable. Catches lying-without-malice. Advisory by default. Builds on the Onlooker ecosystem plugin.",
   "author": {
     "name": "Onlooker Community",

package/plugins/assayer/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.1.2](https://github.com/onlooker-community/ecosystem/compare/assayer-v1.1.1...assayer-v1.1.2) (2026-08-02)
+
+
+### Bug Fixes
+
+* restore config convenience functions & refactor execution plugins to shared loader ([#128](https://github.com/onlooker-community/ecosystem/issues/128)) ([4b3660c](https://github.com/onlooker-community/ecosystem/commit/4b3660c5a8b234187ec1e71c37b63e6a3d305c98))
+
 ## [1.1.1](https://github.com/onlooker-community/ecosystem/compare/assayer-v1.1.0...assayer-v1.1.1) (2026-08-01)
 
 

package/plugins/assayer/scripts/lib/assayer-config.sh

@@ -1,82 +1,59 @@
 #!/usr/bin/env bash
-# Config loading for Assayer.
-# Reads the repo's .claude/settings.json assayer.* keys, falling back to the
-# plugin's own config.json defaults.
-
-_ASSAYER_CONFIG_JSON=""
-_ASSAYER_PLUGIN_CONFIG_JSON=""
+# Config resolution for assayer.
+#
+# Uses the shared config loader from ecosystem. Reads five layers, latest wins:
+#   1. plugins/assayer/config.json (defaults shipped with the plugin)
+#   2. ~/.claude/settings.json
+#   3. ~/.claude/settings.local.json (local overrides user)
+#   4. <repo>/.claude/settings.json
+#   5. <repo>/.claude/settings.local.json (local overrides project)
+#
+# Exposes:
+#   assayer_config_load <repo_root>    # populates _assayer_CONFIG (JSON)
+#   assayer_config_get <jq-path>       # echoes string value (empty if unset)
+#   assayer_config_get_json <jq-path>  # echoes JSON value (null if unset)
+
+# shellcheck source=../../../scripts/lib/config-loader.sh
+source "${PLUGIN_ROOT}/../../scripts/lib/config-loader.sh"
+
+_assayer_CONFIG="{}"
 
 assayer_config_load() {
 	local repo_root="${1:-}"
-
-	_ASSAYER_PLUGIN_CONFIG_JSON=""
-	local plugin_config="${CLAUDE_PLUGIN_ROOT:-}/config.json"
-	if [[ -f "$plugin_config" ]]; then
-		_ASSAYER_PLUGIN_CONFIG_JSON=$(cat "$plugin_config" 2>/dev/null) || _ASSAYER_PLUGIN_CONFIG_JSON=""
-	fi
-
-	_ASSAYER_CONFIG_JSON=""
-	if [[ -n "$repo_root" ]]; then
-		local settings_file="${repo_root}/.claude/settings.json"
-		if [[ -f "$settings_file" ]]; then
-			local settings
-			settings=$(cat "$settings_file" 2>/dev/null) || settings=""
-			local block
-			block=$(printf '%s' "$settings" | jq -c '.assayer // empty' 2>/dev/null) || block=""
-			[[ -n "$block" ]] && _ASSAYER_CONFIG_JSON="$block"
-		fi
-	fi
+	config_load_plugin "assayer" "$repo_root" "_assayer_CONFIG"
+	return 0
 }
 
-# Get a single scalar value. Checks settings.json first, then plugin config.json.
 assayer_config_get() {
-	local key="$1"
-
-	if [[ -n "$_ASSAYER_CONFIG_JSON" ]]; then
-		local val
-		val=$(printf '%s' "$_ASSAYER_CONFIG_JSON" | jq -r "${key} // empty" 2>/dev/null) || val=""
-		[[ -n "$val" && "$val" != "null" ]] && {
-			printf '%s' "$val"
-			return 0
-		}
-	fi
-
-	if [[ -n "$_ASSAYER_PLUGIN_CONFIG_JSON" ]]; then
-		local val
-		val=$(printf '%s' "$_ASSAYER_PLUGIN_CONFIG_JSON" | jq -r ".assayer${key} // empty" 2>/dev/null) || val=""
-		[[ -n "$val" && "$val" != "null" ]] && {
-			printf '%s' "$val"
-			return 0
-		}
-	fi
+	local path="$1"
+	config_get "_assayer_CONFIG" "${path}"
 }
 
-assayer_config_model() {
-	local val
-	val=$(assayer_config_get '.evaluation.model')
-	printf '%s' "${val:-claude-haiku-4-5-20251001}"
+assayer_config_get_json() {
+	local path="$1"
+	config_get_json "_assayer_CONFIG" "${path}"
 }
 
-assayer_config_timeout() {
-	local val
-	val=$(assayer_config_get '.evaluation.timeout_seconds')
-	printf '%s' "${val:-60}"
+assayer_config_model() {
+	local v
+	v=$(assayer_config_get '.assayer.evaluation.model')
+	printf '%s' "${v:-claude-haiku-4-5-20251001}"
 }
 
 assayer_config_max_claims() {
-	local val
-	val=$(assayer_config_get '.max_claims')
-	printf '%s' "${val:-12}"
+	local v
+	v=$(assayer_config_get '.assayer.max_claims')
+	printf '%s' "${v:-12}"
 }
 
 assayer_config_min_confidence() {
-	local val
-	val=$(assayer_config_get '.min_confidence')
-	printf '%s' "${val:-0.5}"
+	local v
+	v=$(assayer_config_get '.assayer.min_confidence')
+	printf '%s' "${v:-0.5}"
 }
 
-assayer_config_final_message_chars() {
-	local val
-	val=$(assayer_config_get '.final_message_chars')
-	printf '%s' "${val:-6000}"
+assayer_config_timeout() {
+	local v
+	v=$(assayer_config_get '.assayer.evaluation.timeout_seconds')
+	printf '%s' "${v:-60}"
 }

package/plugins/bursar/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "bursar",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Multi-session, per-project budget accounting for the Onlooker ecosystem. Rolls each session's spend into a per-project ledger on SessionEnd and surfaces \"this project burned $X this week\" at SessionStart. Where governor regulates a single session, bursar is the cross-session rollup: it reads governor.session.complete off the shared event bus and emits bursar.* events for audit. Named for the officer who keeps the accounts. Builds on the Onlooker ecosystem plugin.",
   "author": {
     "name": "Onlooker Community",

package/plugins/bursar/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.3.0](https://github.com/onlooker-community/ecosystem/compare/bursar-v0.2.2...bursar-v0.3.0) (2026-08-02)
+
+
+### Features
+
+* **config:** add shared config loader supporting all five settings layers :sparkles: ([#123](https://github.com/onlooker-community/ecosystem/issues/123)) ([c048b76](https://github.com/onlooker-community/ecosystem/commit/c048b76bee2b39abeb7f1af77181191dd48f9cf5))
+
+
+### Bug Fixes
+
+* **hooks:** prevent SessionEnd timeouts causing breadcrumb accumulation ([#121](https://github.com/onlooker-community/ecosystem/issues/121)) ([3c7a409](https://github.com/onlooker-community/ecosystem/commit/3c7a40937aa3ea8c1db85dd0bb3fcc22589bbb49))
+
 ## [0.2.2](https://github.com/onlooker-community/ecosystem/compare/bursar-v0.2.1...bursar-v0.2.2) (2026-08-02)
 
 

package/plugins/bursar/scripts/hooks/bursar-session-end.sh

@@ -148,12 +148,13 @@ MODEL=""
 # must keep the breadcrumb so the session→project attribution survives for a
 # later attempt rather than being lost behind a false "recorded" event.
 #
-# Use a longer lock timeout (60s) to handle high concurrency: under typical
-# usage, SessionEnd hooks from concurrent sessions compete for the per-project
-# ledger lock. The default 5s timeout is too aggressive with 100+ concurrent
-# sessions, leading to silent recording failures and breadcrumb accumulation.
+# Use a short lock timeout (1s) to ensure the hook completes within the CLI's
+# 1.5s SessionEnd budget. If the lock is contended, fail fast and retain the
+# breadcrumb for retry on a future session. Retries on subsequent SessionStart
+# will eventually succeed when contention subsides; this prevents the hook from
+# being cancelled mid-execution by the CLI timeout.
 if [[ -n "$RECORD" ]]; then
-	if bursar_ledger_record "$PROJECT_KEY" "$RECORD" 60; then
+	if bursar_ledger_record "$PROJECT_KEY" "$RECORD" 1; then
 		[[ -n "$EV" ]] && bursar_emit_event "bursar.session.recorded" "$EV" "$SESSION_ID" || true
 		rm -f "$BREADCRUMB" 2>/dev/null || true
 	else

package/plugins/bursar/scripts/lib/bursar-config.sh

@@ -1,10 +1,12 @@
 #!/usr/bin/env bash
 # Config resolution for bursar.
 #
-# Reads three layers, latest wins:
+# Uses the shared config loader from ecosystem. Reads five layers, latest wins:
 #   1. plugins/bursar/config.json (defaults shipped with the plugin)
 #   2. ~/.claude/settings.json
-#   3. <repo>/.claude/settings.json
+#   3. ~/.claude/settings.local.json (local overrides user)
+#   4. <repo>/.claude/settings.json
+#   5. <repo>/.claude/settings.local.json (local overrides project)
 #
 # Exposes:
 #   bursar_config_load <repo_root>     # populates _BURSAR_CONFIG (JSON)
@@ -14,60 +16,25 @@
 #   bursar_config_surface_enabled      # 0 if bursar.surface_at_session_start is true
 #   bursar_config_week_start           # echoes "monday" or "sunday"
 
+# shellcheck source=../../../scripts/lib/config-loader.sh
+source "${PLUGIN_ROOT}/../../scripts/lib/config-loader.sh"
+
 _BURSAR_CONFIG="{}"
 
 bursar_config_load() {
 	local repo_root="${1:-}"
-	local plugin_root="${CLAUDE_PLUGIN_ROOT:-}"
-	local home_dir="${HOME:-}"
-
-	# Read each layer's raw text with the no-fork `$(<file)` builtin (NOT `cat`),
-	# then deep-merge all three layers in a SINGLE jq invocation. The dominant
-	# cost in the SessionEnd hook is jq process startup, not the merge itself, so
-	# this collapses what was one-jq-per-file (up to 6 forks) down to one.
-	local default_txt="" home_txt="" repo_txt=""
-	local default_file="${plugin_root}/config.json"
-	local home_file="${home_dir}/.claude/settings.json"
-	local repo_file=""
-	[[ -n "$repo_root" ]] && repo_file="${repo_root}/.claude/settings.json"
-
-	[[ -f "$default_file" ]] && default_txt="$(<"$default_file")"
-	[[ -f "$home_file" ]] && home_txt="$(<"$home_file")"
-	[[ -n "$repo_file" && -f "$repo_file" ]] && repo_txt="$(<"$repo_file")"
-
-	# Precedence (latest wins): defaults < home settings < repo settings. The
-	# defaults file is merged whole; settings files contribute only their .bursar
-	# key. `fromjson? // {}` parses each layer defensively — a missing or malformed
-	# file degrades to {} rather than aborting the merge (matches the prior
-	# per-file fallback).
-	_BURSAR_CONFIG=$(jq -n \
-		--arg d "$default_txt" \
-		--arg h "$home_txt" \
-		--arg r "$repo_txt" \
-		'
-		def deepmerge($a; $b):
-			if ($a|type) == "object" and ($b|type) == "object" then
-				reduce (($a|keys) + ($b|keys) | unique)[] as $k
-					({}; .[$k] = deepmerge($a[$k]; $b[$k]))
-			elif $b == null then $a
-			else $b end;
-		($d | fromjson? // {}) as $defaults
-		| (($h | fromjson? // {}) | {bursar: (.bursar // {})}) as $home
-		| (($r | fromjson? // {}) | {bursar: (.bursar // {})}) as $repo
-		| deepmerge(deepmerge($defaults; $home); $repo)
-		' 2>/dev/null) || _BURSAR_CONFIG="{}"
-	[[ -z "$_BURSAR_CONFIG" ]] && _BURSAR_CONFIG="{}"
+	config_load_plugin "bursar" "$repo_root" "_BURSAR_CONFIG"
 	return 0
 }
 
 bursar_config_get() {
 	local path="$1"
-	printf '%s' "$_BURSAR_CONFIG" | jq -r "${path} // empty" 2>/dev/null
+	config_get "_BURSAR_CONFIG" "${path}"
 }
 
 bursar_config_get_json() {
 	local path="$1"
-	printf '%s' "$_BURSAR_CONFIG" | jq -c "${path}" 2>/dev/null
+	config_get_json "_BURSAR_CONFIG" "${path}"
 }
 
 bursar_config_surface_enabled() {

package/plugins/cartographer/scripts/lib/cartographer-config.sh

@@ -1,54 +1,36 @@
 #!/usr/bin/env bash
 # cartographer-config.sh — load and query Cartographer configuration.
 #
-# Merges three layers in precedence order (later wins):
+# Uses the shared config loader from ecosystem. Merges five layers in precedence order:
 #   1. plugins/cartographer/config.json  (plugin defaults)
 #   2. ~/.claude/settings.json           (.cartographer subtree)
-#   3. <repo>/.claude/settings.json      (.cartographer subtree)
+#   3. ~/.claude/settings.local.json     (.cartographer subtree, local overrides user)
+#   4. <repo>/.claude/settings.json      (.cartographer subtree)
+#   5. <repo>/.claude/settings.local.json (.cartographer subtree, local overrides project)
 #
 # Usage:
 #   cartographer_config_load <repo_root>
 #   cartographer_config_get_json ".cartographer.exclude_paths"
 
+# shellcheck source=../../../scripts/lib/config-loader.sh
+source "${PLUGIN_ROOT}/../../scripts/lib/config-loader.sh"
+
 _CARTOGRAPHER_CONFIG=""
-_CARTOGRAPHER_PLUGIN_CONFIG=""
 
 cartographer_config_load() {
 	local repo_root="${1:-}"
-	local plugin_dir
-	plugin_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
-	local plugin_config="$plugin_dir/config.json"
-
-	_CARTOGRAPHER_PLUGIN_CONFIG="{}"
-	if [[ -f "$plugin_config" ]]; then
-		_CARTOGRAPHER_PLUGIN_CONFIG=$(cat "$plugin_config")
-	fi
-
-	local home_settings="{}"
-	if [[ -f "$HOME/.claude/settings.json" ]]; then
-		home_settings=$(cat "$HOME/.claude/settings.json")
-	fi
-
-	local repo_settings="{}"
-	if [[ -n "$repo_root" && -f "$repo_root/.claude/settings.json" ]]; then
-		repo_settings=$(cat "$repo_root/.claude/settings.json")
-	fi
-
-	_CARTOGRAPHER_CONFIG=$(jq -n \
-		--argjson plugin "$_CARTOGRAPHER_PLUGIN_CONFIG" \
-		--argjson home "$home_settings" \
-		--argjson repo "$repo_settings" \
-		'$plugin * {"cartographer": (($plugin.cartographer // {}) * ($home.cartographer // {}) * ($repo.cartographer // {}))}')
+	config_load_plugin "cartographer" "$repo_root" "_CARTOGRAPHER_CONFIG"
+	return 0
 }
 
 cartographer_config_get() {
 	local path="${1:-}"
-	printf '%s' "$_CARTOGRAPHER_CONFIG" | jq -r "$path // empty" 2>/dev/null
+	config_get "_CARTOGRAPHER_CONFIG" "${path}"
 }
 
 cartographer_config_get_json() {
 	local path="${1:-}"
-	printf '%s' "$_CARTOGRAPHER_CONFIG" | jq -c "$path // empty" 2>/dev/null
+	config_get_json "_CARTOGRAPHER_CONFIG" "${path}"
 }
 
 cartographer_config_model_extraction() {

package/plugins/compass/scripts/lib/compass-config.sh

@@ -1,65 +1,35 @@
 #!/usr/bin/env bash
-# Config resolution for Compass.
+# Config resolution for compass.
 #
-# Reads three layers, latest wins:
+# Uses the shared config loader from ecosystem. Reads five layers, latest wins:
 #   1. plugins/compass/config.json (defaults shipped with the plugin)
 #   2. ~/.claude/settings.json
-#   3. <repo>/.claude/settings.json
+#   3. ~/.claude/settings.local.json (local overrides user)
+#   4. <repo>/.claude/settings.json
+#   5. <repo>/.claude/settings.local.json (local overrides project)
 #
 # Exposes:
-#   compass_config_load <repo_root>     # populates _COMPASS_CONFIG (JSON)
-#   compass_config_get <jq-path>        # echoes string value (empty if unset)
-#   compass_config_get_json <jq-path>   # echoes JSON value (null if unset)
+#   compass_config_load <repo_root>    # populates _compass_CONFIG (JSON)
+#   compass_config_get <jq-path>       # echoes string value (empty if unset)
+#   compass_config_get_json <jq-path>  # echoes JSON value (null if unset)
 
-_COMPASS_CONFIG="{}"
+# shellcheck source=../../../scripts/lib/config-loader.sh
+source "${PLUGIN_ROOT}/../../scripts/lib/config-loader.sh"
+
+_compass_CONFIG="{}"
 
 compass_config_load() {
 	local repo_root="${1:-}"
-	local plugin_root="${CLAUDE_PLUGIN_ROOT:-}"
-	local home_dir="${HOME:-}"
-
-	local merged="{}"
-	local file
-
-	file="${plugin_root}/config.json"
-	if [[ -f "$file" ]]; then
-		local defaults
-		defaults=$(jq '.' "$file" 2>/dev/null) || defaults="{}"
-		merged=$(jq -n --argjson a "$merged" --argjson b "$defaults" '$a * $b' 2>/dev/null) \
-			|| merged="$defaults"
-	fi
-
-	local repo_settings=""
-	[[ -n "$repo_root" ]] && repo_settings="${repo_root}/.claude/settings.json"
-
-	for file in "${home_dir}/.claude/settings.json" "$repo_settings"; do
-		[[ -n "$file" && -f "$file" ]] || continue
-		local overlay
-		overlay=$(jq '{ compass: (.compass // {}) }' "$file" 2>/dev/null) || continue
-		[[ -z "$overlay" ]] && continue
-		local attempt
-		if attempt=$(jq -n --argjson a "$merged" --argjson b "$overlay" '
-			def deepmerge($a; $b):
-				if ($a|type) == "object" and ($b|type) == "object" then
-					reduce (($a|keys) + ($b|keys) | unique)[] as $k
-						({}; .[$k] = deepmerge($a[$k]; $b[$k]))
-				elif $b == null then $a
-				else $b end;
-			deepmerge($a; $b)
-		' 2>/dev/null) && [[ -n "$attempt" ]]; then
-			merged="$attempt"
-		fi
-	done
-
-	_COMPASS_CONFIG="$merged"
+	config_load_plugin "compass" "$repo_root" "_compass_CONFIG"
+	return 0
 }
 
 compass_config_get() {
 	local path="$1"
-	printf '%s' "$_COMPASS_CONFIG" | jq -r "${path} // empty" 2>/dev/null
+	config_get "_compass_CONFIG" "${path}"
 }
 
 compass_config_get_json() {
 	local path="$1"
-	printf '%s' "$_COMPASS_CONFIG" | jq -c "${path}" 2>/dev/null
+	config_get_json "_compass_CONFIG" "${path}"
 }

package/plugins/counsel/scripts/lib/counsel-config.sh

@@ -1,66 +1,35 @@
 #!/usr/bin/env bash
-# Config resolution for Counsel.
+# Config resolution for counsel.
 #
-# Three-layer merge, latest wins:
-#   1. plugins/counsel/config.json   (plugin defaults)
+# Uses the shared config loader from ecosystem. Reads five layers, latest wins:
+#   1. plugins/counsel/config.json (defaults shipped with the plugin)
 #   2. ~/.claude/settings.json
-#   3. <repo>/.claude/settings.json
+#   3. ~/.claude/settings.local.json (local overrides user)
+#   4. <repo>/.claude/settings.json
+#   5. <repo>/.claude/settings.local.json (local overrides project)
 #
 # Exposes:
-#   counsel_config_load <repo_root>    # populates _COUNSEL_CONFIG (JSON)
+#   counsel_config_load <repo_root>    # populates _counsel_CONFIG (JSON)
 #   counsel_config_get <jq-path>       # echoes string value (empty if unset)
 #   counsel_config_get_json <jq-path>  # echoes JSON value (null if unset)
 
-_COUNSEL_CONFIG="{}"
+# shellcheck source=../../../scripts/lib/config-loader.sh
+source "${PLUGIN_ROOT}/../../scripts/lib/config-loader.sh"
+
+_counsel_CONFIG="{}"
 
 counsel_config_load() {
 	local repo_root="${1:-}"
-	local plugin_root="${CLAUDE_PLUGIN_ROOT:-}"
-	local home_dir="${HOME:-}"
-
-	local merged="{}"
-	local file
-
-	file="${plugin_root}/config.json"
-	if [[ -f "$file" ]]; then
-		local defaults
-		defaults=$(jq '.' "$file" 2>/dev/null) || defaults="{}"
-		merged=$(jq -n --argjson a "$merged" --argjson b "$defaults" '$a * $b' 2>/dev/null) \
-			|| merged="$defaults"
-	fi
-
-	local repo_settings=""
-	[[ -n "$repo_root" ]] && repo_settings="${repo_root}/.claude/settings.json"
-
-	for file in "${home_dir}/.claude/settings.json" "$repo_settings"; do
-		[[ -n "$file" && -f "$file" ]] || continue
-		local overlay
-		overlay=$(jq '{ counsel: (.counsel // {}) }' "$file" 2>/dev/null) || continue
-		[[ -z "$overlay" ]] && continue
-		local attempt
-		if attempt=$(jq -n --argjson a "$merged" --argjson b "$overlay" '
-			def deepmerge($a; $b):
-				if ($a|type) == "object" and ($b|type) == "object" then
-					reduce (($a|keys) + ($b|keys) | unique)[] as $k
-						({}; .[$k] = deepmerge($a[$k]; $b[$k]))
-				elif $b == null then $a
-				else $b end;
-			deepmerge($a; $b)
-		' 2>/dev/null) && [[ -n "$attempt" ]]; then
-			merged="$attempt"
-		fi
-	done
-
-	_COUNSEL_CONFIG="$merged"
+	config_load_plugin "counsel" "$repo_root" "_counsel_CONFIG"
+	return 0
 }
 
 counsel_config_get() {
 	local path="$1"
-	printf '%s' "$_COUNSEL_CONFIG" | jq -r "${path} // empty" 2>/dev/null
+	config_get "_counsel_CONFIG" "${path}"
 }
 
 counsel_config_get_json() {
 	local path="$1"
-	printf '%s' "$_COUNSEL_CONFIG" | jq -c "${path}" 2>/dev/null
+	config_get_json "_counsel_CONFIG" "${path}"
 }
-