@onlooker-community/ecosystem 0.32.2 → 0.33.1

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

@@ -1,6 +1,6 @@
 {
   "name": "curator",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Maintenance layer for the user's typed auto-memory store. At every SessionStart, runs four cheap heuristic checks (date_decayed, path_broken, broken_index, orphaned_memory) against the memories at ~/.claude/projects/<encoded>/memory/ inside a wall-clock budget. Surfaces findings as a one-line pointer to /curator review; never edits the memory store directly. Builds on the Onlooker ecosystem plugin.",
   "author": {
     "name": "Onlooker Community",

package/plugins/curator/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.2.2](https://github.com/onlooker-community/ecosystem/compare/curator-v0.2.1...curator-v0.2.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))
+
 ## [0.2.1](https://github.com/onlooker-community/ecosystem/compare/curator-v0.2.0...curator-v0.2.1) (2026-08-01)
 
 

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

@@ -1,60 +1,35 @@
 #!/usr/bin/env bash
-# Config resolution for Curator.
+# Config resolution for curator.
 #
-# Reads three layers, latest wins:
+# Uses the shared config loader from ecosystem. Reads five layers, latest wins:
 #   1. plugins/curator/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:
-#   curator_config_load <repo_root>    # populates _CURATOR_CONFIG (JSON)
+#   curator_config_load <repo_root>    # populates _curator_CONFIG (JSON)
 #   curator_config_get <jq-path>       # echoes string value (empty if unset)
-#
-# Settings overlay only touches the `curator.*` subtree of settings.json.
+#   curator_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"
 
-_CURATOR_CONFIG="{}"
+_curator_CONFIG="{}"
 
 curator_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 '{ curator: (.curator // {}) }' "$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
-
-	_CURATOR_CONFIG="$merged"
+	config_load_plugin "curator" "$repo_root" "_curator_CONFIG"
+	return 0
 }
 
 curator_config_get() {
 	local path="$1"
-	# The `// empty` operator treats `false` the same as null, so a
-	# value of `false` would silently disappear and the caller would
-	# misread "explicitly disabled" as "default to enabled". Use an
-	# explicit null check so booleans round-trip correctly.
-	printf '%s' "$_CURATOR_CONFIG" \
-		| jq -r "${path} | if . == null then empty else . end" 2>/dev/null
+	config_get "_curator_CONFIG" "${path}"
+}
+
+curator_config_get_json() {
+	local path="$1"
+	config_get_json "_curator_CONFIG" "${path}"
 }

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

@@ -1,100 +1,71 @@
 #!/usr/bin/env bash
-# Config loading for Echo.
-# Reads config.json from the repo's .claude/settings.json echo.* keys,
-# falling back to the plugin's own config.json defaults.
+# Config resolution for echo.
+#
+# Uses the shared config loader from ecosystem. Reads five layers, latest wins:
+#   1. plugins/echo/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:
+#   echo_config_load <repo_root>    # populates _echo_CONFIG (JSON)
+#   echo_config_get <jq-path>       # echoes string value (empty if unset)
+#   echo_config_get_json <jq-path>  # echoes JSON value (null if unset)
 
-_ECHO_CONFIG_JSON=""
-_ECHO_PLUGIN_CONFIG_JSON=""
+# shellcheck source=../../../scripts/lib/config-loader.sh
+source "${PLUGIN_ROOT}/../../scripts/lib/config-loader.sh"
+
+_echo_CONFIG="{}"
 
 echo_config_load() {
 	local repo_root="${1:-}"
-
-	_ECHO_PLUGIN_CONFIG_JSON=""
-	local plugin_config="${CLAUDE_PLUGIN_ROOT:-}/config.json"
-	if [[ -f "$plugin_config" ]]; then
-		_ECHO_PLUGIN_CONFIG_JSON=$(cat "$plugin_config" 2>/dev/null) || _ECHO_PLUGIN_CONFIG_JSON=""
-	fi
-
-	_ECHO_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 echo_block
-			echo_block=$(printf '%s' "$settings" | jq -c '.echo // empty' 2>/dev/null) || echo_block=""
-			[[ -n "$echo_block" ]] && _ECHO_CONFIG_JSON="$echo_block"
-		fi
-	fi
+	config_load_plugin "echo" "$repo_root" "_echo_CONFIG"
+	return 0
 }
 
-# Get a single scalar value. Checks settings.json first, then plugin config.json.
 echo_config_get() {
-	local key="$1"
-
-	if [[ -n "$_ECHO_CONFIG_JSON" ]]; then
-		local val
-		val=$(printf '%s' "$_ECHO_CONFIG_JSON" | jq -r "${key} // empty" 2>/dev/null) || val=""
-		[[ -n "$val" && "$val" != "null" ]] && { printf '%s' "$val"; return 0; }
-	fi
-
-	if [[ -n "$_ECHO_PLUGIN_CONFIG_JSON" ]]; then
-		local val
-		val=$(printf '%s' "$_ECHO_PLUGIN_CONFIG_JSON" | jq -r ".echo${key} // empty" 2>/dev/null) || val=""
-		[[ -n "$val" && "$val" != "null" ]] && { printf '%s' "$val"; return 0; }
-	fi
+	local path="$1"
+	config_get "_echo_CONFIG" "${path}"
 }
 
 echo_config_get_json() {
-	local key="$1"
-
-	if [[ -n "$_ECHO_CONFIG_JSON" ]]; then
-		local val
-		val=$(printf '%s' "$_ECHO_CONFIG_JSON" | jq -c "${key} // empty" 2>/dev/null) || val=""
-		[[ -n "$val" && "$val" != "null" && "$val" != "empty" ]] && { printf '%s' "$val"; return 0; }
-	fi
-
-	if [[ -n "$_ECHO_PLUGIN_CONFIG_JSON" ]]; then
-		local val
-		val=$(printf '%s' "$_ECHO_PLUGIN_CONFIG_JSON" | jq -c ".echo${key} // empty" 2>/dev/null) || val=""
-		[[ -n "$val" && "$val" != "null" && "$val" != "empty" ]] && { printf '%s' "$val"; return 0; }
-	fi
+	local path="$1"
+	config_get_json "_echo_CONFIG" "${path}"
 }
 
 echo_config_model() {
 	local val
-	val=$(echo_config_get '.evaluation.model')
+	val=$(echo_config_get '.echo.evaluation.model')
 	printf '%s' "${val:-claude-haiku-4-5-20251001}"
 }
 
 echo_config_timeout() {
 	local val
-	val=$(echo_config_get '.evaluation.timeout_seconds')
+	val=$(echo_config_get '.echo.evaluation.timeout_seconds')
 	printf '%s' "${val:-60}"
 }
 
 echo_config_drift_threshold() {
 	local val
-	val=$(echo_config_get '.drift_threshold')
+	val=$(echo_config_get '.echo.drift_threshold')
 	printf '%s' "${val:-0.05}"
 }
 
-# Prints newline-separated list of watch glob patterns.
 echo_config_watch_paths() {
 	local raw
-	raw=$(echo_config_get_json '.watch_paths')
-	if [[ -n "$raw" ]]; then
+	raw=$(echo_config_get_json '.echo.watch_paths')
+	if [[ -n "$raw" && "$raw" != "null" ]]; then
 		printf '%s' "$raw" | jq -r '.[]' 2>/dev/null
 	else
 		printf 'plugins/*/agents/*.md\n'
 	fi
 }
 
-# Prints newline-separated list of exclude glob patterns.
 echo_config_exclude_paths() {
 	local raw
-	raw=$(echo_config_get_json '.exclude_paths')
-	if [[ -n "$raw" ]]; then
+	raw=$(echo_config_get_json '.echo.exclude_paths')
+	if [[ -n "$raw" && "$raw" != "null" ]]; then
 		printf '%s' "$raw" | jq -r '.[]' 2>/dev/null
 	fi
 	# Always exclude Echo's own tree — hardcoded, not overridable.

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

@@ -1,10 +1,12 @@
 #!/usr/bin/env bash
 # Config resolution for Governor.
 #
-# Reads three layers, latest wins:
+# Uses the shared config loader from ecosystem. Reads five layers, latest wins:
 #   1. plugins/governor/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:
 #   governor_config_load <repo_root>     # populates _GOVERNOR_CONFIG (JSON)
@@ -12,57 +14,25 @@
 #   governor_config_get_json <jq-path>   # echoes JSON value (null if unset)
 #   governor_config_enforcement          # echoes "soft" or "hard"
 
+# shellcheck source=../../../scripts/lib/config-loader.sh
+source "${PLUGIN_ROOT}/../../scripts/lib/config-loader.sh"
+
 _GOVERNOR_CONFIG="{}"
 
 governor_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 '{ governor: (.governor // {}) }' "$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
-
-	_GOVERNOR_CONFIG="$merged"
+	config_load_plugin "governor" "$repo_root" "_GOVERNOR_CONFIG"
+	return 0
 }
 
 governor_config_get() {
 	local path="$1"
-	printf '%s' "$_GOVERNOR_CONFIG" | jq -r "${path} // empty" 2>/dev/null
+	config_get "_GOVERNOR_CONFIG" "${path}"
 }
 
 governor_config_get_json() {
 	local path="$1"
-	printf '%s' "$_GOVERNOR_CONFIG" | jq -c "${path}" 2>/dev/null
+	config_get_json "_GOVERNOR_CONFIG" "${path}"
 }
 
 governor_config_enforcement() {

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

@@ -1,10 +1,12 @@
 #!/usr/bin/env bash
 # Config resolution for Historian.
 #
-# Reads three layers, latest wins:
+# Uses the shared config loader from ecosystem. Reads five layers, latest wins:
 #   1. plugins/historian/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:
 #   historian_config_load <repo_root>    # populates _HISTORIAN_CONFIG (JSON)
@@ -12,41 +14,15 @@
 #
 # Settings overlay only touches the `historian.*` subtree of settings.json.
 
+# shellcheck source=../../../scripts/lib/config-loader.sh
+source "${PLUGIN_ROOT}/../../scripts/lib/config-loader.sh"
+
 _HISTORIAN_CONFIG="{}"
 
 historian_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 '{ historian: (.historian // {}) }' "$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
-
-	_HISTORIAN_CONFIG="$merged"
+	config_load_plugin "historian" "$repo_root" "_HISTORIAN_CONFIG"
+	return 0
 }
 
 # Read a value from the loaded config. The explicit null check (instead of

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

@@ -1,6 +1,6 @@
 {
   "name": "inspector",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Per-edit lint and typecheck gate. Runs the project's configured checks on just the touched file after every Write / Edit / MultiEdit, so the agent sees its own type errors before claiming success. Cheaper than proctor (which runs project-wide verification at Stop); complements assayer (which catches the agent lying about claims). Builds on the Onlooker ecosystem plugin.",
   "author": {
     "name": "Onlooker Community",

package/plugins/inspector/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.3.2](https://github.com/onlooker-community/ecosystem/compare/inspector-v0.3.1...inspector-v0.3.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))
+
 ## [0.3.1](https://github.com/onlooker-community/ecosystem/compare/inspector-v0.3.0...inspector-v0.3.1) (2026-08-01)
 
 

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

@@ -1,62 +1,37 @@
 #!/usr/bin/env bash
-# inspector-config.sh — load and query Inspector configuration.
+# Config resolution for inspector.
 #
-# Merges three layers in precedence order (later wins):
-#   1. plugins/inspector/config.json    (plugin defaults)
-#   2. ~/.claude/settings.json          (.inspector subtree)
-#   3. <repo>/.claude/settings.json     (.inspector subtree)
+# Uses the shared config loader from ecosystem. Reads five layers, latest wins:
+#   1. plugins/inspector/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)
 #
-# Usage:
-#   inspector_config_load <repo_root>
-#   inspector_config_get ".inspector.timeout_seconds_per_check"
-#   inspector_config_get_json ".inspector.exclude_paths"
-#   inspector_config_checks_for_extension ".ts"
+# Exposes:
+#   inspector_config_load <repo_root>    # populates _inspector_CONFIG (JSON)
+#   inspector_config_get <jq-path>       # echoes string value (empty if unset)
+#   inspector_config_get_json <jq-path>  # echoes JSON value (null if unset)
 
-_INSPECTOR_CONFIG=""
-_INSPECTOR_PLUGIN_CONFIG=""
+# shellcheck source=../../../scripts/lib/config-loader.sh
+source "${PLUGIN_ROOT}/../../scripts/lib/config-loader.sh"
+
+_inspector_CONFIG="{}"
 
 inspector_config_load() {
 	local repo_root="${1:-}"
-	local plugin_dir
-	plugin_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
-	local plugin_config="$plugin_dir/config.json"
-
-	_INSPECTOR_PLUGIN_CONFIG="{}"
-	if [[ -f "$plugin_config" ]]; then
-		_INSPECTOR_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
-
-	_INSPECTOR_CONFIG=$(jq -n \
-		--argjson plugin "$_INSPECTOR_PLUGIN_CONFIG" \
-		--argjson home "$home_settings" \
-		--argjson repo "$repo_settings" \
-		'$plugin * {"inspector": (($plugin.inspector // {}) * ($home.inspector // {}) * ($repo.inspector // {}))}')
+	config_load_plugin "inspector" "$repo_root" "_inspector_CONFIG"
+	return 0
 }
 
 inspector_config_get() {
-	local path="${1:-}"
-	printf '%s' "$_INSPECTOR_CONFIG" | jq -r "$path // empty" 2>/dev/null
+	local path="$1"
+	config_get "_inspector_CONFIG" "${path}"
 }
 
 inspector_config_get_json() {
-	local path="${1:-}"
-	printf '%s' "$_INSPECTOR_CONFIG" | jq -c "$path // empty" 2>/dev/null
-}
-
-inspector_config_show_clean_runs() {
-	local v
-	v=$(inspector_config_get '.inspector.show_clean_runs')
-	[[ "$v" == "true" ]]
+	local path="$1"
+	config_get_json "_inspector_CONFIG" "${path}"
 }
 
 inspector_config_timeout_per_check() {
@@ -77,25 +52,26 @@ inspector_config_output_excerpt_max_bytes() {
 	printf '%s' "${v:-4096}"
 }
 
+inspector_config_show_clean_runs() {
+	local v
+	v=$(inspector_config_get '.inspector.show_clean_runs')
+	[[ "$v" == "true" ]]
+}
+
 inspector_config_exclude_paths() {
-	inspector_config_get_json '.inspector.exclude_paths // []'
+	inspector_config_get_json '.inspector.exclude_paths // ["node_modules",".git","vendor",".venv","dist",".next",".nuxt","build","__pycache__","target","coverage"]'
 }
 
-# Emits a JSON array of {name, argv, kind} objects for the given file extension
-# (including the leading dot). Returns an empty array when no checks are
-# configured for the extension.
 inspector_config_checks_for_extension() {
-	local ext="${1:-}"
-	[[ -z "$ext" ]] && { printf '[]'; return; }
-	printf '%s' "$_INSPECTOR_CONFIG" | jq -c --arg ext "$ext" '
-		(.inspector.checks // {}) as $checks
-		| ($checks[$ext] // [])
-		| map(
-			if type == "array" then
-				{ name: (.[0] // "check"), argv: ., kind: "lint" }
-			else
-				{ name: (.name // "check"), argv: (.argv // []), kind: (.kind // "lint") }
-			end
-		)
-	' 2>/dev/null || printf '[]'
+	local ext="$1"
+	[[ -z "$ext" ]] && { printf '%s\n' "[]"; return 0; }
+	local raw
+	raw=$(inspector_config_get_json ".inspector.checks[\"$ext\"] // []")
+	[[ -z "$raw" ]] && { printf '%s\n' "[]"; return 0; }
+	# Normalize bare argv arrays into objects with name, kind, argv fields
+	printf '%s' "$raw" | jq -c 'map(
+		if type == "array" then
+			{name: .[0], kind: "lint", argv: .}
+		else . end
+	)'
 }

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

@@ -1,6 +1,6 @@
 {
   "name": "librarian",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Consolidation layer between archivist's per-session artifacts and the user's durable typed memory store. Detects which session decisions, dead-ends, and open questions deserve to live across sessions, classifies them into the user/feedback/project/reference types, and queues them as proposals for explicit confirmation. Auto-promotion is opt-in. Builds on the Onlooker ecosystem plugin.",
   "author": {
     "name": "Onlooker Community",

package/plugins/librarian/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.6.1](https://github.com/onlooker-community/ecosystem/compare/librarian-v0.6.0...librarian-v0.6.1) (2026-08-02)
+
+
+### 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.6.0](https://github.com/onlooker-community/ecosystem/compare/librarian-v0.5.0...librarian-v0.6.0) (2026-08-02)
 
 

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

@@ -60,6 +60,17 @@ source "${PLUGIN_ROOT}/scripts/lib/librarian-classifier.sh"
 # shellcheck source=../lib/librarian-conflict-detector.sh
 source "${PLUGIN_ROOT}/scripts/lib/librarian-conflict-detector.sh"
 
+librarian_now_ms() {
+	local now_ms
+	now_ms=$(python3 - <<'PY' 2>/dev/null
+import time
+print(int(time.time() * 1000))
+PY
+	) || now_ms=""
+	[[ -z "$now_ms" ]] && now_ms=$(( $(date +%s) * 1000 ))
+	printf '%s' "$now_ms"
+}
+
 INPUT=$(cat 2>/dev/null || true)
 CWD=$(printf '%s' "$INPUT" | jq -r '.cwd // ""' 2>/dev/null) || CWD=""
 SESSION_ID=$(printf '%s' "$INPUT" | jq -r '.session_id // ""' 2>/dev/null) || SESSION_ID=""
@@ -98,7 +109,7 @@ fi
 # Emit scan.started and load candidate window.
 # ----------------------------------------------------------------------------
 
-SCAN_START_TS_S=$(date +%s)
+SCAN_START_TS_MS=$(librarian_now_ms)
 ARTIFACTS=$(librarian_archivist_load_since "$PROJECT_KEY" "$WATERMARK")
 ARTIFACT_COUNT=$(printf '%s' "$ARTIFACTS" | jq 'length' 2>/dev/null) || ARTIFACT_COUNT=0
 
@@ -114,7 +125,7 @@ librarian_emit "librarian.scan.started" "$SESSION_ID" "$(jq -cn \
 # don't re-walk the same window.
 if [[ "$ARTIFACT_COUNT" == "0" ]]; then
 	librarian_storage_write_last_scan "$PROJECT_KEY" || true
-	DURATION_MS=$(( ($(date +%s) - SCAN_START_TS_S) * 1000 ))
+	DURATION_MS=$(( $(librarian_now_ms) - SCAN_START_TS_MS ))
 	librarian_emit "librarian.scan.complete" "$SESSION_ID" "$(jq -cn \
 		--arg outcome "empty" \
 		--argjson duration_ms "$DURATION_MS" \
@@ -155,6 +166,30 @@ for ((i = 0; i < DROPPED_EMIT_COUNT; i++)); do
 		 | with_entries(select(.value != null))')"
 done
 
+# ----------------------------------------------------------------------------
+# Runtime budget check: SessionEnd has 1.5s total. If we're running low on time,
+# skip classification to ensure scan.complete can be emitted before CLI timeout.
+# Retained artifacts will be re-scanned on the next session when time permits.
+# ----------------------------------------------------------------------------
+
+ELAPSED_MS=$(( $(librarian_now_ms) - SCAN_START_TS_MS ))
+BUDGET_THRESHOLD_MS=1000
+if [[ "$ELAPSED_MS" -ge "$BUDGET_THRESHOLD_MS" ]]; then
+	librarian_storage_write_last_scan "$PROJECT_KEY" || true
+	DURATION_MS=$(( $(librarian_now_ms) - SCAN_START_TS_MS ))
+	librarian_emit "librarian.scan.complete" "$SESSION_ID" "$(jq -cn \
+		--arg outcome "budget_exceeded" \
+		--argjson duration_ms "$DURATION_MS" \
+		--argjson candidates_proposed 0 \
+		--argjson candidates_dropped "$DROPPED_TOTAL" \
+		--argjson artifact_count_in_window "$ARTIFACT_COUNT" \
+		'{ outcome: $outcome, duration_ms: $duration_ms,
+		   candidates_proposed: $candidates_proposed,
+		   candidates_dropped: $candidates_dropped,
+		   artifact_count_in_window: $artifact_count_in_window }')"
+	exit 0
+fi
+
 # ----------------------------------------------------------------------------
 # Classifier loop — one Haiku call per surviving candidate.
 # ----------------------------------------------------------------------------
@@ -398,7 +433,7 @@ librarian_storage_write_last_scan "$PROJECT_KEY" || true
 TOTAL_DROPPED=$((DROPPED_TOTAL + POST_CLASSIFIER_DROPPED))
 OUTCOME="ok"
 [[ "$PROPOSED_COUNT" == "0" ]] && OUTCOME="empty"
-DURATION_MS=$(( ($(date +%s) - SCAN_START_TS_S) * 1000 ))
+DURATION_MS=$(( $(librarian_now_ms) - SCAN_START_TS_MS ))
 
 librarian_emit "librarian.scan.complete" "$SESSION_ID" "$(jq -cn \
 	--arg outcome "$OUTCOME" \