@onlooker-community/ecosystem 0.16.0 → 0.18.0

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

@@ -0,0 +1,114 @@
+#!/usr/bin/env bash
+# Event log reader for Counsel.
+#
+# Reads $ONLOOKER_EVENTS_LOG and returns a filtered, summarized view of
+# the last N days suitable for passing to the synthesis prompt.
+#
+# Exposes:
+#   counsel_read_events <lookback_days> <chars_max>
+#     Echoes a structured text summary of events, or empty string on failure.
+#
+#   counsel_sources_from_events <events_json>
+#     Echoes a JSON array of CounselSource strings present in the event batch.
+
+# Maps event_type prefixes to CounselSource values.
+_counsel_source_for_type() {
+	local event_type="${1:-}"
+	case "$event_type" in
+		tribunal.*)     printf 'tribunal_verdicts' ;;
+		echo.*)         printf 'echo_regressions' ;;
+		sentinel.*)     printf 'sentinel_audit' ;;
+		warden.*)       printf 'warden_audit' ;;
+		oracle.*)       printf 'oracle_calibrations' ;;
+		meridian.*)     printf 'meridian_reliance' ;;
+		*)              printf 'onlooker_events' ;;
+	esac
+}
+
+counsel_read_events() {
+	local lookback_days="${1:-30}"
+	local chars_max="${2:-60000}"
+
+	local log_path="${ONLOOKER_EVENTS_LOG:-${ONLOOKER_DIR:-$HOME/.onlooker}/logs/onlooker-events.jsonl}"
+	[[ -f "$log_path" ]] || { printf ''; return 0; }
+
+	# Compute cutoff as an ISO 8601 date string. ISO 8601 strings are
+	# lexicographically sortable, so string comparison is safe for filtering.
+	local cutoff_ts
+	if [[ "$(uname)" == "Darwin" ]]; then
+		cutoff_ts=$(date -v "-${lookback_days}d" -u '+%Y-%m-%dT%H:%M:%SZ' 2>/dev/null) \
+			|| cutoff_ts=""
+	else
+		cutoff_ts=$(date -d "-${lookback_days} days" -u '+%Y-%m-%dT%H:%M:%SZ' 2>/dev/null) \
+			|| cutoff_ts=""
+	fi
+
+	# Filter to events within the lookback window. If cutoff_ts is empty (date
+	# command unavailable) fall through and include all events.
+	local summary
+	# -rc: compact output keeps each object on one line (JSONL-shaped), which
+	# downstream counsel_count_events and counsel_sources_from_events require.
+	summary=$(jq -rc --arg cutoff "$cutoff_ts" '
+		select(.timestamp != null) |
+		select($cutoff == "" or .timestamp >= $cutoff) |
+		{
+			type:      .event_type,
+			plugin:    (.plugin // "unknown"),
+			ts:        .timestamp,
+			session:   (.session_id // ""),
+			payload:   (.payload // {})
+		}
+	' "$log_path" 2>/dev/null | head -c "$chars_max") || summary=""
+
+	printf '%s' "$summary"
+}
+
+counsel_sources_from_events() {
+	local events_text="${1:-}"
+	[[ -z "$events_text" ]] && { printf '["onlooker_events"]'; return 0; }
+
+	local sources=()
+	local seen_tribunal=0 seen_echo=0 seen_sentinel=0 seen_warden=0 seen_oracle=0 seen_meridian=0 seen_other=0
+
+	while IFS= read -r line; do
+		[[ -z "$line" ]] && continue
+		local etype
+		etype=$(printf '%s' "$line" | jq -r '.type // ""' 2>/dev/null) || continue
+		case "$etype" in
+			tribunal.*)  seen_tribunal=1 ;;
+			echo.*)      seen_echo=1 ;;
+			sentinel.*)  seen_sentinel=1 ;;
+			warden.*)    seen_warden=1 ;;
+			oracle.*)    seen_oracle=1 ;;
+			meridian.*)  seen_meridian=1 ;;
+			*)           seen_other=1 ;;
+		esac
+	done <<< "$events_text"
+
+	[[ "$seen_other" -eq 1 ]]    && sources+=("\"onlooker_events\"")
+	[[ "$seen_tribunal" -eq 1 ]] && sources+=("\"tribunal_verdicts\"")
+	[[ "$seen_echo" -eq 1 ]]     && sources+=("\"echo_regressions\"")
+	[[ "$seen_sentinel" -eq 1 ]] && sources+=("\"sentinel_audit\"")
+	[[ "$seen_warden" -eq 1 ]]   && sources+=("\"warden_audit\"")
+	[[ "$seen_oracle" -eq 1 ]]   && sources+=("\"oracle_calibrations\"")
+	[[ "$seen_meridian" -eq 1 ]] && sources+=("\"meridian_reliance\"")
+
+	if [[ "${#sources[@]}" -eq 0 ]]; then
+		printf '["onlooker_events"]'
+		return 0
+	fi
+
+	local joined
+	joined=$(IFS=,; printf '%s' "${sources[*]}")
+	printf '[%s]' "$joined"
+}
+
+counsel_count_events() {
+	local events_text="${1:-}"
+	[[ -z "$events_text" ]] && { printf '0'; return 0; }
+	local count=0
+	while IFS= read -r line; do
+		[[ -n "$line" ]] && count=$((count + 1))
+	done <<< "$events_text"
+	printf '%s' "$count"
+}

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

@@ -0,0 +1,103 @@
+#!/usr/bin/env bash
+# Synthesis pass for Counsel.
+#
+# Runs a single Haiku call over the event summary to produce a structured
+# improvement brief. The brief is returned as a JSON object.
+#
+# Exposes:
+#   counsel_synthesize <events_text> <model> <timeout_s> <max_tokens> <temperature>
+#     Echoes a JSON object on success, empty string on failure.
+#     JSON shape:
+#       {
+#         "summary":         string,
+#         "patterns":        [string],
+#         "recommendations": [{title, rationale, priority:"high"|"medium"|"low"}],
+#         "wins":            [string],
+#         "watch":           [string]
+#       }
+
+_COUNSEL_SYNTHESIS_PROMPT='You are an engineering coach analyzing an AI agent observability log. You have been given a structured dump of plugin events from the onlooker ecosystem over the past several weeks. Your job is to synthesize patterns, surface improvement opportunities, and highlight what is working well.
+
+Focus on:
+- Recurring failure modes or blocked gates (tribunal, sentinel, warden)
+- Prompt regression trends (echo plugin)
+- Budget or resource pressure patterns (governor plugin)
+- Quality trends over time
+- What the team is consistently doing well
+
+Return a JSON object with exactly these keys:
+{
+  "summary": "2-3 sentence executive summary of the period",
+  "patterns": ["observed pattern — what is happening and how often"],
+  "recommendations": [
+    {
+      "title": "short action title",
+      "rationale": "1-2 sentences explaining why this matters",
+      "priority": "high"
+    }
+  ],
+  "wins": ["thing that is working well — be specific"],
+  "watch": ["trend to monitor — not urgent but worth watching"]
+}
+
+Rules:
+- All fields are required; use empty arrays [] if no items found
+- recommendations must have priority: "high", "medium", or "low"
+- Keep each item to 1-2 sentences
+- Return ONLY the JSON object — no prose, no markdown fences, no explanation
+- If there is insufficient data to draw conclusions, say so in summary and return empty arrays
+
+'
+
+counsel_synthesize() {
+	local events_text="${1:-}"
+	local model="${2:-claude-haiku-4-5-20251001}"
+	local timeout_s="${3:-90}"
+	local max_tokens="${4:-4096}"
+	local temperature="${5:-0.4}"
+
+	[[ -z "$events_text" ]] && return 1
+
+	if ! command -v claude >/dev/null 2>&1; then
+		printf 'counsel_synthesize: claude CLI not found\n' >&2
+		return 1
+	fi
+
+	local prompt_file
+	prompt_file=$(mktemp -t counsel-synth.XXXXXX 2>/dev/null) || prompt_file="/tmp/counsel-synth.$$"
+	trap 'rm -f "$prompt_file"' RETURN
+
+	{
+		printf '%s' "$_COUNSEL_SYNTHESIS_PROMPT"
+		printf '<event_log>\n'
+		printf '%s\n' "$events_text"
+		printf '</event_log>\n'
+	} > "$prompt_file"
+
+	local claude_args=(-p --max-turns 1 --model "$model" --max-tokens "$max_tokens")
+
+	local response=""
+	if command -v timeout >/dev/null 2>&1; then
+		response=$(timeout "$timeout_s" claude "${claude_args[@]}" < "$prompt_file" 2>/dev/null) || response=""
+	elif command -v gtimeout >/dev/null 2>&1; then
+		response=$(gtimeout "$timeout_s" claude "${claude_args[@]}" < "$prompt_file" 2>/dev/null) || response=""
+	else
+		response=$(claude "${claude_args[@]}" < "$prompt_file" 2>/dev/null) || response=""
+	fi
+
+	[[ -z "$response" ]] && return 1
+
+	# Strip markdown fences if present.
+	local clean
+	clean=$(printf '%s' "$response" \
+		| sed -e 's/^```json[[:space:]]*//' -e 's/^```[[:space:]]*//' -e 's/[[:space:]]*```$//')
+
+	if ! printf '%s' "$clean" | jq -e \
+		'.summary and (.patterns | type == "array") and (.recommendations | type == "array") and (.wins | type == "array") and (.watch | type == "array")' \
+		>/dev/null 2>&1; then
+		printf 'counsel_synthesize: response missing required keys\n' >&2
+		return 1
+	fi
+
+	printf '%s' "$clean"
+}

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

@@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+# Minimal ULID generator for Counsel brief IDs.
+
+_COUNSEL_ULID_ALPHABET="0123456789ABCDEFGHJKMNPQRSTVWXYZ"
+
+_counsel_ulid_encode() {
+	local n="$1"
+	local len="$2"
+	local out=""
+	local i
+	for ((i = 0; i < len; i++)); do
+		out="${_COUNSEL_ULID_ALPHABET:$((n % 32)):1}${out}"
+		n=$((n / 32))
+	done
+	printf '%s' "$out"
+}
+
+counsel_ulid() {
+	local now_ms
+	if [[ "$(uname)" == "Darwin" ]]; then
+		now_ms=$(python3 -c 'import time; print(int(time.time() * 1000))' 2>/dev/null) \
+			|| now_ms=$(($(date +%s) * 1000))
+	else
+		now_ms=$(date +%s%3N 2>/dev/null) || now_ms=$(($(date +%s) * 1000))
+	fi
+
+	local rand_hex rand_hi rand_lo
+	rand_hex=$(openssl rand -hex 10 2>/dev/null)
+	if [[ -n "$rand_hex" && ${#rand_hex} -eq 20 ]]; then
+		rand_hi=$((16#${rand_hex:0:10}))
+		rand_lo=$((16#${rand_hex:10:10}))
+	else
+		rand_hi=$((RANDOM * 32768 + RANDOM))
+		rand_lo=$((RANDOM * 32768 + RANDOM))
+		rand_hi=$(((rand_hi * 256 + RANDOM % 256) & ((1 << 40) - 1)))
+		rand_lo=$(((rand_lo * 256 + RANDOM % 256) & ((1 << 40) - 1)))
+	fi
+
+	local ts_part hi_part lo_part
+	ts_part=$(_counsel_ulid_encode "$now_ms" 10)
+	hi_part=$(_counsel_ulid_encode "$rand_hi" 8)
+	lo_part=$(_counsel_ulid_encode "$rand_lo" 8)
+
+	printf '%s%s%s' "$ts_part" "$hi_part" "$lo_part"
+}

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

@@ -1,6 +1,6 @@
 {
   "name": "governor",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Resource governance and budget enforcement for the Onlooker ecosystem. Tracks per-session token and cost spend, gates Task spawns before they exceed a configurable budget ceiling, and emits governor.* events for audit. Named for the steam-engine governor — a device that regulates output. Builds on the Onlooker ecosystem plugin.",
   "author": {
     "name": "Onlooker Community",

package/plugins/governor/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.2.0](https://github.com/onlooker-community/ecosystem/compare/governor-v0.1.0...governor-v0.2.0) (2026-05-26)
+
+
+### Features
+
+* **governor:** resource governance and budget enforcement plugin :rocket: ([#43](https://github.com/onlooker-community/ecosystem/issues/43)) ([04e6d70](https://github.com/onlooker-community/ecosystem/commit/04e6d7051f27db752bb121d389d65b4d8ade04ad))
+
 ## [0.1.0] - 2026-05-25
 
 ### Added

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

@@ -0,0 +1,12 @@
+{
+  "name": "scribe",
+  "version": "0.2.0",
+  "description": "Intent documentation from agent activity. Captures why changes were made — problem context, decisions, tradeoffs — and distills them into readable artifacts at session end.",
+  "author": {
+    "name": "Onlooker Community",
+    "email": "community@onlooker.dev"
+  },
+  "homepage": "https://onlooker.dev",
+  "license": "MIT",
+  "requires": ["ecosystem"]
+}

package/plugins/scribe/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## [0.2.0](https://github.com/onlooker-community/ecosystem/compare/scribe-v0.1.0...scribe-v0.2.0) (2026-06-01)
+
+
+### Features
+
+* **scribe:** intent documentation from agent activity :pencil2: ([#50](https://github.com/onlooker-community/ecosystem/issues/50)) ([f0a95d1](https://github.com/onlooker-community/ecosystem/commit/f0a95d1058e36d1bb5f0f645964d9e88e8f98b66))

package/plugins/scribe/config.json

@@ -0,0 +1,20 @@
+{
+  "scribe": {
+    "enabled": true,
+    "evaluator": {
+      "model": "claude-haiku-4-5-20251001",
+      "timeout": 60,
+      "max_tokens": 2048,
+      "temperature": 0.3
+    },
+    "capture": {
+      "min_turns": 3,
+      "prompt_max_chars": 1000,
+      "transcript_chars_max": 40000
+    },
+    "output": {
+      "mirror_to_project": false,
+      "project_dir": "docs/decisions"
+    }
+  }
+}

package/plugins/scribe/hooks/hooks.json

@@ -0,0 +1,37 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PLUGIN_ROOT\"/scripts/hooks/scribe-session-start.sh"
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PLUGIN_ROOT\"/scripts/hooks/scribe-capture.sh"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PLUGIN_ROOT\"/scripts/hooks/scribe-stop.sh"
+          }
+        ]
+      }
+    ]
+  }
+}

package/plugins/scribe/scripts/hooks/scribe-capture.sh

@@ -0,0 +1,76 @@
+#!/usr/bin/env bash
+# Scribe UserPromptSubmit hook — initial intent capture.
+#
+# Fires on every user prompt. On the FIRST turn of a session (captured_prompt
+# is null in state), extracts and stores the prompt text as the problem
+# statement seed for later distillation.
+#
+# Subsequent turns are ignored — the full transcript is available at Stop
+# time, so there is no need to accumulate per-turn captures.
+#
+# Hook contract:
+#   - Always exits 0. Never blocks a user prompt.
+#   - Errors are written to stderr only; stdout is kept clean.
+
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/../.." && pwd)"
+
+export CLAUDE_PLUGIN_ROOT="$PLUGIN_ROOT"
+
+# shellcheck source=../lib/scribe-config.sh
+source "${PLUGIN_ROOT}/scripts/lib/scribe-config.sh"
+
+INPUT=$(cat)
+SESSION_ID=$(printf '%s' "$INPUT" | jq -r '.session_id // ""' 2>/dev/null) || SESSION_ID=""
+CWD=$(printf '%s' "$INPUT" | jq -r '.cwd // ""' 2>/dev/null) || CWD=""
+PROMPT=$(printf '%s' "$INPUT" | jq -r '.prompt // ""' 2>/dev/null) || PROMPT=""
+
+_done() { exit 0; }
+
+[[ -z "$SESSION_ID" || -z "$PROMPT" ]] && _done
+
+scribe_config_load "$CWD"
+
+if ! scribe_config_enabled; then
+	_done
+fi
+
+ONLOOKER_DIR="${ONLOOKER_DIR:-${HOME}/.onlooker}"
+STATE_FILE="${ONLOOKER_DIR}/scribe/sessions/${SESSION_ID}.json"
+
+# Only capture if no prompt has been stored yet for this session.
+if [[ -f "$STATE_FILE" ]]; then
+	existing=$(jq -r '.captured_prompt // "null"' "$STATE_FILE" 2>/dev/null) || existing="null"
+	[[ "$existing" != "null" && -n "$existing" ]] && _done
+fi
+
+# Truncate prompt to configured max chars.
+max_chars=$(scribe_config_get '.scribe.capture.prompt_max_chars')
+[[ -z "$max_chars" || "$max_chars" == "null" ]] && max_chars="1000"
+
+truncated="${PROMPT:0:$max_chars}"
+timestamp=$(date -u '+%Y-%m-%dT%H:%M:%SZ' 2>/dev/null) || timestamp=""
+
+# Upsert state — preserve existing keys, update captured_prompt + captured_at.
+if [[ -f "$STATE_FILE" ]]; then
+	updated=$(jq \
+		--arg p "$truncated" \
+		--arg ts "$timestamp" \
+		'.captured_prompt = $p | .captured_at = $ts' \
+		"$STATE_FILE" 2>/dev/null) || updated=""
+	if [[ -n "$updated" ]]; then
+		printf '%s\n' "$updated" > "$STATE_FILE" || true
+	fi
+else
+	mkdir -p "$(dirname "$STATE_FILE")" 2>/dev/null || true
+	jq -n \
+		--arg sid "$SESSION_ID" \
+		--arg p "$truncated" \
+		--arg ts "$timestamp" \
+		'{session_id: $sid, captured_prompt: $p, captured_at: $ts}' \
+		2>/dev/null > "$STATE_FILE" || true
+fi
+
+_done

package/plugins/scribe/scripts/hooks/scribe-session-start.sh

@@ -0,0 +1,58 @@
+#!/usr/bin/env bash
+# Scribe SessionStart hook.
+#
+# Fires at every session start. Responsibilities:
+#   1. Skip silently when scribe.enabled is false.
+#   2. Create storage directories.
+#   3. Initialize session state file:
+#      - captured_prompt: null (populated by scribe-capture.sh on first turn)
+#      - captured_at: null
+#
+# Hook contract:
+#   - Always exits 0. Never blocks SessionStart.
+#   - Errors are written to stderr only; stdout is kept clean.
+
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/../.." && pwd)"
+
+export CLAUDE_PLUGIN_ROOT="$PLUGIN_ROOT"
+
+# shellcheck source=../lib/scribe-config.sh
+source "${PLUGIN_ROOT}/scripts/lib/scribe-config.sh"
+
+INPUT=$(cat)
+SESSION_ID=$(printf '%s' "$INPUT" | jq -r '.session_id // ""' 2>/dev/null) || SESSION_ID=""
+CWD=$(printf '%s' "$INPUT" | jq -r '.cwd // ""' 2>/dev/null) || CWD=""
+
+_done() { exit 0; }
+
+scribe_config_load "$CWD"
+
+if ! scribe_config_enabled; then
+	_done
+fi
+
+export _HOOK_SESSION_ID="$SESSION_ID"
+
+ONLOOKER_DIR="${ONLOOKER_DIR:-${HOME}/.onlooker}"
+SCRIBE_SESSION_DIR="${ONLOOKER_DIR}/scribe/sessions"
+mkdir -p "$SCRIBE_SESSION_DIR" 2>/dev/null || true
+
+[[ -z "$SESSION_ID" ]] && _done
+
+STATE_FILE="${SCRIBE_SESSION_DIR}/${SESSION_ID}.json"
+
+jq -n \
+	--arg sid "$SESSION_ID" \
+	'{
+		session_id: $sid,
+		captured_prompt: null,
+		captured_at: null
+	}' 2>/dev/null > "$STATE_FILE" || {
+	printf 'scribe-session-start: failed to write state file %s\n' "$STATE_FILE" >&2
+	_done
+}
+
+_done

package/plugins/scribe/scripts/hooks/scribe-stop.sh

@@ -0,0 +1,67 @@
+#!/usr/bin/env bash
+# Scribe Stop hook — intent distillation.
+#
+# Fires when the agent session ends. Reads the full session transcript,
+# runs a Haiku extraction pass to identify the problem context, decisions,
+# tradeoffs, and constraints, then writes a Markdown intent document to
+# ~/.onlooker/scribe/<project_key>/<date>-<session>.md.
+#
+# Skip conditions (all silent):
+#   - scribe.enabled is false
+#   - no transcript_path in hook input, or file is unreadable
+#   - session has fewer turns than scribe.capture.min_turns
+#
+# Hook contract:
+#   - Always exits 0. Never blocks Stop.
+#   - Errors are written to stderr only; stdout is kept clean.
+
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/../.." && pwd)"
+
+export CLAUDE_PLUGIN_ROOT="$PLUGIN_ROOT"
+
+# shellcheck source=../lib/scribe-config.sh
+source "${PLUGIN_ROOT}/scripts/lib/scribe-config.sh"
+# shellcheck source=../lib/scribe-events.sh
+source "${PLUGIN_ROOT}/scripts/lib/scribe-events.sh"
+# shellcheck source=../lib/scribe-project-key.sh
+source "${PLUGIN_ROOT}/scripts/lib/scribe-project-key.sh"
+# shellcheck source=../lib/scribe-extract.sh
+source "${PLUGIN_ROOT}/scripts/lib/scribe-extract.sh"
+# shellcheck source=../lib/scribe-distill.sh
+source "${PLUGIN_ROOT}/scripts/lib/scribe-distill.sh"
+
+INPUT=$(cat)
+SESSION_ID=$(printf '%s' "$INPUT" | jq -r '.session_id // ""' 2>/dev/null) || SESSION_ID=""
+CWD=$(printf '%s' "$INPUT" | jq -r '.cwd // ""' 2>/dev/null) || CWD=""
+TRANSCRIPT_PATH=$(printf '%s' "$INPUT" | jq -r '.transcript_path // ""' 2>/dev/null) || TRANSCRIPT_PATH=""
+
+export _HOOK_SESSION_ID="$SESSION_ID"
+
+_done() { exit 0; }
+
+[[ -z "$SESSION_ID" ]] && _done
+
+scribe_config_load "$CWD"
+
+if ! scribe_config_enabled; then
+	_done
+fi
+
+if [[ -z "$TRANSCRIPT_PATH" || ! -f "$TRANSCRIPT_PATH" ]]; then
+	_done
+fi
+
+_distill_rc=0
+output_path=$(scribe_distill "$SESSION_ID" "$CWD" "$TRANSCRIPT_PATH") || _distill_rc=$?
+if [[ $_distill_rc -ne 0 ]]; then
+	# rc=2 means below min_turns — silent skip, not an error.
+	[[ $_distill_rc -ne 2 ]] && printf 'scribe-stop: distillation failed for session %s\n' "$SESSION_ID" >&2
+	_done
+fi
+
+[[ -n "$output_path" ]] && printf 'scribe: intent document written → %s\n' "$output_path" >&2
+
+_done

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

@@ -0,0 +1,72 @@
+#!/usr/bin/env bash
+# Config resolution for Scribe.
+#
+# Reads three layers, latest wins:
+#   1. plugins/scribe/config.json (defaults shipped with the plugin)
+#   2. ~/.claude/settings.json
+#   3. <repo>/.claude/settings.json
+#
+# Exposes:
+#   scribe_config_load <repo_root>     # populates _SCRIBE_CONFIG (JSON)
+#   scribe_config_get <jq-path>        # echoes string value (empty if unset)
+#   scribe_config_get_json <jq-path>   # echoes JSON value (null if unset)
+#   scribe_config_enabled              # 0 if scribe.enabled is true
+
+_SCRIBE_CONFIG="{}"
+
+scribe_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 '{ scribe: (.scribe // {}) }' "$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
+
+	_SCRIBE_CONFIG="$merged"
+}
+
+scribe_config_get() {
+	local path="$1"
+	printf '%s' "$_SCRIBE_CONFIG" | jq -r "${path} // empty" 2>/dev/null
+}
+
+scribe_config_get_json() {
+	local path="$1"
+	printf '%s' "$_SCRIBE_CONFIG" | jq -c "${path}" 2>/dev/null
+}
+
+scribe_config_enabled() {
+	local v
+	v=$(scribe_config_get '.scribe.enabled')
+	[[ "$v" == "true" ]]
+}