@onlooker-community/ecosystem 0.29.2 → 0.29.3

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "ecosystem",
-  "version": "0.29.2",
+  "version": "0.29.3",
   "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,5 +1,5 @@
 {
-  ".": "0.29.2",
+  ".": "0.29.3",
   "plugins/archivist": "0.1.0",
   "plugins/tribunal": "1.0.1",
   "plugins/echo": "0.2.0",
@@ -13,7 +13,7 @@
   "plugins/curator": "0.1.0",
   "plugins/historian": "0.2.0",
   "plugins/assayer": "1.0.0",
-  "plugins/bursar": "0.1.0",
+  "plugins/bursar": "0.1.1",
   "plugins/lineage": "0.1.0",
   "plugins/inspector": "0.2.0"
 }

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.29.3](https://github.com/onlooker-community/ecosystem/compare/ecosystem-v0.29.2...ecosystem-v0.29.3) (2026-06-24)
+
+
+### Performance Improvements
+
+* **bursar:** collapse process forks in SessionEnd hot path :relieved: ([#101](https://github.com/onlooker-community/ecosystem/issues/101)) ([7a426fe](https://github.com/onlooker-community/ecosystem/commit/7a426fe359785eca35ea1ad61523b05fda79e0da))
+
 ## [0.29.2](https://github.com/onlooker-community/ecosystem/compare/ecosystem-v0.29.1...ecosystem-v0.29.2) (2026-06-21)
 
 

package/package.json

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

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

@@ -1,6 +1,6 @@
 {
   "name": "bursar",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "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,12 @@
 # Changelog
 
+## [0.1.1](https://github.com/onlooker-community/ecosystem/compare/bursar-v0.1.0...bursar-v0.1.1) (2026-06-24)
+
+
+### Performance Improvements
+
+* **bursar:** collapse process forks in SessionEnd hot path :relieved: ([#101](https://github.com/onlooker-community/ecosystem/issues/101)) ([7a426fe](https://github.com/onlooker-community/ecosystem/commit/7a426fe359785eca35ea1ad61523b05fda79e0da))
+
 ## [0.1.0](https://github.com/onlooker-community/ecosystem/compare/bursar-v0.0.1...bursar-v0.1.0) (2026-06-12)
 
 

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

@@ -33,11 +33,12 @@ source "${PLUGIN_ROOT}/scripts/lib/bursar-project-key.sh"
 source "${PLUGIN_ROOT}/scripts/lib/bursar-ledger.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; }
 
+# Parse session_id and cwd in a single jq pass (one fork, not two).
+{ IFS= read -r SESSION_ID; IFS= read -r CWD; } < <(printf '%s' "$INPUT" | jq -r '.session_id // "", .cwd // ""' 2>/dev/null)
+
 [[ -z "$SESSION_ID" ]] && _done
 
 ONLOOKER_DIR="${ONLOOKER_DIR:-${HOME}/.onlooker}"
@@ -47,11 +48,13 @@ TRACKER="${ONLOOKER_DIR}/session-trackers/${SESSION_ID}"
 
 # -----------------------------------------------------------------------
 # Resolve project key + cwd: breadcrumb → substrate tracker → live cwd.
+# The breadcrumb (dropped at SessionStart) usually carries both, which lets us
+# skip the git + shasum project-key derivation entirely in the common case.
 # -----------------------------------------------------------------------
 PROJECT_KEY=""
 if [[ -f "$BREADCRUMB" ]]; then
-	PROJECT_KEY=$(jq -r '.project_key // ""' "$BREADCRUMB" 2>/dev/null) || PROJECT_KEY=""
-	[[ -z "$CWD" ]] && CWD=$(jq -r '.cwd // ""' "$BREADCRUMB" 2>/dev/null)
+	{ IFS= read -r PROJECT_KEY; IFS= read -r bc_cwd; } < <(jq -r '.project_key // "", .cwd // ""' "$BREADCRUMB" 2>/dev/null)
+	[[ -z "$CWD" ]] && CWD="$bc_cwd"
 fi
 if [[ -z "$CWD" && -f "$TRACKER" ]]; then
 	CWD=$(jq -r '.cwd // ""' "$TRACKER" 2>/dev/null) || CWD=""
@@ -74,66 +77,74 @@ COST=""
 TOKENS=""
 CALLS=""
 
-# Reads event-log lines on stdin; echoes the latest matching session.complete payload.
-_latest_governor_payload() {
+# Reads event-log lines on stdin; emits one TSV line "cost<TAB>tokens<TAB>calls"
+# for the latest governor.session.complete matching this session (empty if none).
+# grep pre-filters so jq only parses the handful of matching lines, and the
+# field extraction happens in the same jq pass that selects the latest match —
+# replacing the prior select + three separate jq extractions.
+_latest_governor_spend() {
 	grep -F '"governor.session.complete"' 2>/dev/null \
-		| jq -c --arg sid "$SESSION_ID" \
-			'select(.event_type == "governor.session.complete" and .payload.session_id == $sid) | .payload' \
-			2>/dev/null \
-		| tail -n 1
+		| jq -rs --arg sid "$SESSION_ID" '
+			[ .[]
+			  | select(.event_type == "governor.session.complete" and .payload.session_id == $sid)
+			  | .payload ]
+			| if length == 0 then empty
+			  else (.[-1] | [(.total_cost_usd // ""), (.total_tokens // ""), (.total_api_calls // "")] | @tsv)
+			  end' \
+			2>/dev/null
 }
 
 if [[ -f "$LOG" ]]; then
 	# The matching event was emitted seconds ago (governor's final Stop), so it is
 	# almost always near the tail. Scan a recent slice first to keep this hook
 	# fast as the global log grows; fall back to the full file only on a miss.
-	SPEND=$(tail -n 2000 "$LOG" 2>/dev/null | _latest_governor_payload)
-	[[ -z "$SPEND" ]] && SPEND=$(_latest_governor_payload < "$LOG")
+	SPEND=$(tail -n 2000 "$LOG" 2>/dev/null | _latest_governor_spend)
+	[[ -z "$SPEND" ]] && SPEND=$(_latest_governor_spend < "$LOG")
 	if [[ -n "$SPEND" ]]; then
 		GOV_PRESENT="true"
-		COST=$(printf '%s' "$SPEND" | jq -r '.total_cost_usd // empty' 2>/dev/null) || COST=""
-		TOKENS=$(printf '%s' "$SPEND" | jq -r '.total_tokens // empty' 2>/dev/null) || TOKENS=""
-		CALLS=$(printf '%s' "$SPEND" | jq -r '.total_api_calls // empty' 2>/dev/null) || CALLS=""
+		IFS=$'\t' read -r COST TOKENS CALLS <<<"$SPEND"
 	fi
 fi
 
 MODEL=""
 [[ -f "$TRACKER" ]] && MODEL=$(jq -r '.model // ""' "$TRACKER" 2>/dev/null)
 
+# One date fork yields both the epoch and the RFC3339 stamp (was two).
+{ IFS= read -r NOW_EPOCH; IFS= read -r NOW_ISO; } < <(date -u +'%s%n%Y-%m-%dT%H:%M:%SZ' 2>/dev/null)
+[[ -z "$NOW_EPOCH" ]] && NOW_EPOCH=0
+
 # -----------------------------------------------------------------------
-# Build the record and the event payload, attaching spend fields only when
-# governor supplied them.
+# Build the ledger record AND the (smaller) event payload in a single jq pass.
+# Spend fields are passed as strings and coerced with tonumber so an empty value
+# is simply omitted — replacing the per-field add_fields() helper that forked a
+# jq for every field, twice. The event payload is the record minus the
+# ledger-only ts/ts_epoch fields.
 # -----------------------------------------------------------------------
-add_fields() {
-	# Echoes the input JSON ($1) with cost/tokens/calls/model merged in.
-	local base="$1"
-	[[ -n "$COST" ]] && base=$(printf '%s' "$base" | jq --argjson v "$COST" '. + {cost_usd: $v}' 2>/dev/null)
-	[[ -n "$TOKENS" ]] && base=$(printf '%s' "$base" | jq --argjson v "$TOKENS" '. + {tokens: $v}' 2>/dev/null)
-	[[ -n "$CALLS" ]] && base=$(printf '%s' "$base" | jq --argjson v "$CALLS" '. + {api_calls: $v}' 2>/dev/null)
-	[[ -n "$MODEL" ]] && base=$(printf '%s' "$base" | jq --arg v "$MODEL" '. + {model: $v}' 2>/dev/null)
-	printf '%s' "$base"
-}
-
-RECORD=$(jq -n \
-	--arg ts "$(bursar_now_iso)" \
-	--argjson te "$(bursar_now_epoch)" \
+{ IFS= read -r RECORD; IFS= read -r EV; } < <(jq -rn \
+	--arg ts "$NOW_ISO" \
+	--argjson te "$NOW_EPOCH" \
 	--arg sid "$SESSION_ID" \
 	--arg pk "$PROJECT_KEY" \
 	--argjson gp "$GOV_PRESENT" \
-	'{ts: $ts, ts_epoch: $te, session_id: $sid, project_key: $pk, governor_present: $gp}' 2>/dev/null)
-RECORD=$(add_fields "$RECORD")
+	--arg cost "$COST" \
+	--arg tokens "$TOKENS" \
+	--arg calls "$CALLS" \
+	--arg model "$MODEL" \
+	'
+	( {ts: $ts, ts_epoch: $te, session_id: $sid, project_key: $pk, governor_present: $gp}
+	  + (if $cost   != "" then {cost_usd:  ($cost   | tonumber)} else {} end)
+	  + (if $tokens != "" then {tokens:    ($tokens | tonumber)} else {} end)
+	  + (if $calls  != "" then {api_calls: ($calls  | tonumber)} else {} end)
+	  + (if $model  != "" then {model: $model} else {} end)
+	) as $record
+	| ($record | tojson), ($record | del(.ts, .ts_epoch) | tojson)
+	' 2>/dev/null)
 
 # Only claim the session was recorded — and only drop the breadcrumb — once the
 # ledger upsert actually succeeds. A failed write (lock timeout, mv failure)
 # must keep the breadcrumb so the session→project attribution survives for a
 # later attempt rather than being lost behind a false "recorded" event.
 if [[ -n "$RECORD" ]] && bursar_ledger_record "$PROJECT_KEY" "$RECORD"; then
-	EV=$(jq -n \
-		--arg pk "$PROJECT_KEY" \
-		--arg sid "$SESSION_ID" \
-		--argjson gp "$GOV_PRESENT" \
-		'{project_key: $pk, session_id: $sid, governor_present: $gp}' 2>/dev/null)
-	EV=$(add_fields "$EV")
 	[[ -n "$EV" ]] && bursar_emit_event "bursar.session.recorded" "$EV" "$SESSION_ID" || true
 
 	rm -f "$BREADCRUMB" 2>/dev/null || true

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

@@ -21,40 +21,43 @@ bursar_config_load() {
 	local plugin_root="${CLAUDE_PLUGIN_ROOT:-}"
 	local home_dir="${HOME:-}"
 
-	local merged="{}"
-	local file
+	# 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"
 
-	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
+	[[ -f "$default_file" ]] && default_txt="$(<"$default_file")"
+	[[ -f "$home_file" ]] && home_txt="$(<"$home_file")"
+	[[ -n "$repo_file" && -f "$repo_file" ]] && repo_txt="$(<"$repo_file")"
 
-	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 '{ bursar: (.bursar // {}) }' "$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
-
-	_BURSAR_CONFIG="$merged"
+	# 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="{}"
+	return 0
 }
 
 bursar_config_get() {

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

@@ -55,12 +55,13 @@ bursar_ledger_record() {
 	local record="${2:-}"
 	[[ -z "$project_key" || -z "$record" ]] && return 1
 
-	local sid
-	sid=$(printf '%s' "$record" | jq -r '.session_id // empty' 2>/dev/null) || sid=""
-	[[ -z "$sid" ]] && return 1
-
-	local record_compact
-	record_compact=$(printf '%s' "$record" | jq -c . 2>/dev/null) || return 1
+	# Pull the session_id and the compacted record out in a single jq pass:
+	# line 1 is the key, line 2 is the line we will write.
+	local sid record_compact
+	{ IFS= read -r sid; IFS= read -r record_compact; } < <(
+		printf '%s' "$record" | jq -r '.session_id // empty, tojson' 2>/dev/null
+	)
+	[[ -z "$sid" || -z "$record_compact" ]] && return 1
 
 	local dir ledger_path lock_path
 	dir=$(bursar_ledger_dir "$project_key")