@onlooker-community/ecosystem 0.31.1 → 0.31.2

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "ecosystem",
-  "version": "0.31.1",
+  "version": "0.31.2",
   "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.31.1",
+  ".": "0.31.2",
   "plugins/archivist": "0.3.1",
   "plugins/tribunal": "1.1.1",
   "plugins/echo": "0.3.1",
@@ -11,7 +11,7 @@
   "plugins/warden": "0.3.1",
   "plugins/librarian": "0.4.1",
   "plugins/curator": "0.2.1",
-  "plugins/historian": "0.3.1",
+  "plugins/historian": "0.3.2",
   "plugins/assayer": "1.1.1",
   "plugins/bursar": "0.2.1",
   "plugins/lineage": "0.2.1",

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.31.2](https://github.com/onlooker-community/ecosystem/compare/ecosystem-v0.31.1...ecosystem-v0.31.2) (2026-08-01)
+
+
+### Bug Fixes
+
+* **historian:** export CLAUDE_PLUGIN_ROOT so config loads correctly :bug: ([#112](https://github.com/onlooker-community/ecosystem/issues/112)) ([f24b0b4](https://github.com/onlooker-community/ecosystem/commit/f24b0b4375c64385fefd329cd07d8874785002e9))
+
 ## [0.31.1](https://github.com/onlooker-community/ecosystem/compare/ecosystem-v0.31.0...ecosystem-v0.31.1) (2026-08-01)
 
 

package/package.json

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

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

@@ -1,6 +1,6 @@
 {
   "name": "historian",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Episodic memory layer. At SessionEnd, chunks and sanitizes the session transcript and stores chunks under $ONLOOKER_DIR/historian/<project-key>/sessions/ (default $HOME/.onlooker). On UserPromptSubmit, embeds the prompt and performs similarity retrieval over stored chunks to surface relevant past context. Builds on the Onlooker ecosystem plugin.",
   "author": {
     "name": "Onlooker Community",

package/plugins/historian/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.3.2](https://github.com/onlooker-community/ecosystem/compare/historian-v0.3.1...historian-v0.3.2) (2026-08-01)
+
+
+### Bug Fixes
+
+* **historian:** export CLAUDE_PLUGIN_ROOT so config loads correctly :bug: ([#112](https://github.com/onlooker-community/ecosystem/issues/112)) ([f24b0b4](https://github.com/onlooker-community/ecosystem/commit/f24b0b4375c64385fefd329cd07d8874785002e9))
+
 ## [0.3.1](https://github.com/onlooker-community/ecosystem/compare/historian-v0.3.0...historian-v0.3.1) (2026-08-01)
 
 

package/plugins/historian/scripts/hooks/historian-prompt-submit.sh

@@ -50,7 +50,8 @@ if [[ -z "$_ECOSYSTEM_ROOT" ]]; then
 fi
 if [[ -n "$_ECOSYSTEM_ROOT" && -f "${_ECOSYSTEM_ROOT}/scripts/lib/validate-path.sh" ]]; then
 	# shellcheck disable=SC1091
-	CLAUDE_PLUGIN_ROOT="$_ECOSYSTEM_ROOT" source "${_ECOSYSTEM_ROOT}/scripts/lib/validate-path.sh"
+	export CLAUDE_PLUGIN_ROOT="$PLUGIN_ROOT"
+	source "${_ECOSYSTEM_ROOT}/scripts/lib/validate-path.sh"
 fi
 
 # shellcheck source=../lib/historian-config.sh

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

@@ -37,7 +37,8 @@ if [[ -z "$_ECOSYSTEM_ROOT" ]]; then
 fi
 if [[ -n "$_ECOSYSTEM_ROOT" && -f "${_ECOSYSTEM_ROOT}/scripts/lib/validate-path.sh" ]]; then
 	# shellcheck disable=SC1091
-	CLAUDE_PLUGIN_ROOT="$_ECOSYSTEM_ROOT" source "${_ECOSYSTEM_ROOT}/scripts/lib/validate-path.sh"
+	export CLAUDE_PLUGIN_ROOT="$PLUGIN_ROOT"
+	source "${_ECOSYSTEM_ROOT}/scripts/lib/validate-path.sh"
 fi
 
 # shellcheck source=../lib/historian-config.sh

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

@@ -57,6 +57,8 @@ source "${PLUGIN_ROOT}/scripts/lib/librarian-archivist-reader.sh"
 source "${PLUGIN_ROOT}/scripts/lib/librarian-durability.sh"
 # shellcheck source=../lib/librarian-classifier.sh
 source "${PLUGIN_ROOT}/scripts/lib/librarian-classifier.sh"
+# shellcheck source=../lib/librarian-conflict-detector.sh
+source "${PLUGIN_ROOT}/scripts/lib/librarian-conflict-detector.sh"
 
 INPUT=$(cat 2>/dev/null || true)
 CWD=$(printf '%s' "$INPUT" | jq -r '.cwd // ""' 2>/dev/null) || CWD=""
@@ -232,14 +234,75 @@ for ((i = 0; i < KEPT_COUNT; i++)); do
 		continue
 	fi
 
-	# Build and persist the proposal. Conflict detection against the user's
-	# memory store is deferred to a follow-up commit; everything ships as
-	# conflict_state: "none" for now.
+	# Build and persist the proposal. Detect conflicts against the user's
+	# memory store before writing.
 	PROPOSAL_ID=$(librarian_ulid)
 	FILENAME=$(librarian_classifier_filename "$MEMORY_TYPE" "$TITLE")
 	ARTIFACT_ID=$(printf '%s' "$ARTIFACT" | jq -r '.id // ""')
 	ARTIFACT_SESSION=$(printf '%s' "$ARTIFACT" | jq -r '.session_id // ""')
 
+	# Resolve the typed memory store path for this project.
+	MEMORY_STORE_PATH=$(librarian_config_get '.librarian.memory_store_path')
+	[[ -z "$MEMORY_STORE_PATH" || "$MEMORY_STORE_PATH" == "null" ]] && \
+		MEMORY_STORE_PATH='${HOME}/.claude/projects/${CLAUDE_PROJECT_ENCODED}/memory'
+
+	# Expand env vars in the path.
+	MEMORY_STORE_PATH=$(eval echo "$MEMORY_STORE_PATH")
+
+	# Initialize conflict state; will scan if memory dir exists.
+	CONFLICT_STATE="none"
+	CONFLICT_WITH="[]"
+
+	# Detect conflicts against existing memories only if the directory exists.
+	if [[ -d "$MEMORY_STORE_PATH" ]]; then
+		# Build a temporary proposal for conflict detection.
+		TEMP_PROPOSAL=$(jq -n \
+			--arg id "$PROPOSAL_ID" \
+			--arg memory_type "$MEMORY_TYPE" \
+			--arg filename "$FILENAME" \
+			--arg title "$TITLE" \
+			--arg body "$BODY" \
+			--argjson classifier_confidence "$CONFIDENCE" \
+			'{
+				id: $id,
+				proposed: {
+					type: $memory_type,
+					filename: $filename,
+					title: $title,
+					body: $body,
+					classifier_confidence: $classifier_confidence
+				}
+			}')
+
+		# Detect conflicts against existing memories.
+		DUP_THRESHOLD=$(librarian_config_get '.librarian.conflict.duplicate_threshold')
+		[[ -z "$DUP_THRESHOLD" || "$DUP_THRESHOLD" == "null" ]] && DUP_THRESHOLD="0.7"
+		MERGE_THRESHOLD=$(librarian_config_get '.librarian.conflict.merge_candidate_threshold')
+		[[ -z "$MERGE_THRESHOLD" || "$MERGE_THRESHOLD" == "null" ]] && MERGE_THRESHOLD="0.45"
+
+		CONFLICT_RESULT=$(librarian_conflict_scan "$TEMP_PROPOSAL" "$MEMORY_STORE_PATH" \
+			"$DUP_THRESHOLD" "$MERGE_THRESHOLD" 2>/dev/null) || CONFLICT_RESULT=""
+
+		# Ensure we have valid JSON; fall back to "none" if scan fails.
+		if [[ -z "$CONFLICT_RESULT" ]] || ! printf '%s' "$CONFLICT_RESULT" | jq -e '.' >/dev/null 2>&1; then
+			CONFLICT_RESULT='{"conflict_state":"none","conflict_with":[]}'
+		fi
+
+		CONFLICT_STATE=$(printf '%s' "$CONFLICT_RESULT" | jq -r '.conflict_state // "none"' 2>/dev/null) || CONFLICT_STATE="none"
+		CONFLICT_WITH=$(printf '%s' "$CONFLICT_RESULT" | jq -c '.conflict_with // []' 2>/dev/null) || CONFLICT_WITH="[]"
+
+		# Silently drop duplicates — no proposal written.
+		if [[ "$CONFLICT_STATE" == "duplicate" ]]; then
+			POST_CLASSIFIER_DROPPED=$((POST_CLASSIFIER_DROPPED + 1))
+			librarian_emit "librarian.candidate.dropped" "$SESSION_ID" "$(jq -cn \
+				--arg reason "duplicate" \
+				--arg src "$ARTIFACT_ID" \
+				'{ reason: $reason, source_artifact_id: (if $src == "" then null else $src end) }
+				 | with_entries(select(.value != null))')"
+			continue
+		fi
+	fi
+
 	PROPOSAL_JSON=$(jq -n \
 		--arg id "$PROPOSAL_ID" \
 		--arg created_at "$NOW_TS" \
@@ -248,7 +311,8 @@ for ((i = 0; i < KEPT_COUNT; i++)); do
 		--arg title "$TITLE" \
 		--arg body "$BODY" \
 		--argjson classifier_confidence "$CONFIDENCE" \
-		--arg conflict_state "none" \
+		--arg conflict_state "$CONFLICT_STATE" \
+		--argjson conflict_with "$CONFLICT_WITH" \
 		--arg artifact_id "$ARTIFACT_ID" \
 		--arg artifact_session "$ARTIFACT_SESSION" \
 		'{
@@ -264,7 +328,7 @@ for ((i = 0; i < KEPT_COUNT; i++)); do
 				classifier_confidence: $classifier_confidence
 			},
 			conflict_state: $conflict_state,
-			conflict_with: [],
+			conflict_with: $conflict_with,
 			status: "pending"
 		}')
 
@@ -314,7 +378,7 @@ for ((i = 0; i < KEPT_COUNT; i++)); do
 		--arg proposal_id "$PROPOSAL_ID" \
 		--arg memory_type "$MEMORY_TYPE" \
 		--argjson classifier_confidence "$CONFIDENCE" \
-		--arg conflict_state "none" \
+		--arg conflict_state "$CONFLICT_STATE" \
 		--arg src "$ARTIFACT_ID" \
 		'{
 			proposal_id: $proposal_id,

package/plugins/librarian/scripts/lib/librarian-conflict-detector.sh

@@ -0,0 +1,215 @@
+#!/usr/bin/env bash
+# Conflict and duplicate detection for librarian proposals.
+#
+# Compares proposed memories against existing memories in the user's
+# typed memory store (~/.claude/projects/<encoded>/memory/) and classifies
+# each proposal into one of:
+#   - none           (no similarity, safe to propose)
+#   - duplicate      (similarity >= duplicate_threshold; drop silently)
+#   - merge_candidate (merge_threshold <= similarity < duplicate_threshold)
+#   - conflict_candidate (opposing sentiment on overlapping content)
+#
+# Uses deterministic token-set Jaccard similarity (no LLM call) with
+# configurable thresholds.
+
+# Extract and normalize tokens from text for similarity comparison.
+# Lowercases, removes stopwords, splits on non-alphanumeric.
+_librarian_conflict_normalize() {
+	local text="$1"
+	printf '%s' "$text" \
+		| tr '[:upper:]' '[:lower:]' \
+		| tr -cs '[:alnum:]' '\n' \
+		| grep -v '^$' \
+		| sort -u \
+		| paste -sd ' ' -
+}
+
+# Compute Jaccard similarity (intersection / union) of two token sets.
+# Input: two space-separated token strings.
+# Output: float 0-1.
+_librarian_conflict_jaccard() {
+	local tokens1="$1"
+	local tokens2="$2"
+
+	[[ -z "$tokens1" || -z "$tokens2" ]] && { printf '0'; return; }
+
+	TOKENS1="$tokens1" TOKENS2="$tokens2" python3 -c '
+import os
+tokens1 = set(os.environ.get("TOKENS1", "").split())
+tokens2 = set(os.environ.get("TOKENS2", "").split())
+if not tokens1 and not tokens2:
+    print(0)
+else:
+    intersection = len(tokens1 & tokens2)
+    union = len(tokens1 | tokens2)
+    similarity = intersection / union if union > 0 else 0
+    print(f"{similarity:.2f}")
+'
+}
+
+# Check for opposing sentiment markers (do/don't, always/never, etc.).
+# Returns 0 if opposing markers found, 1 otherwise.
+_librarian_conflict_opposing_sentiment() {
+	local text1="$1"
+	local text2="$2"
+
+	# Normalize to lowercase.
+	text1=$(printf '%s' "$text1" | tr '[:upper:]' '[:lower:]')
+	text2=$(printf '%s' "$text2" | tr '[:upper:]' '[:lower:]')
+
+	# Define opposing pairs.
+	local -a pairs=("always:never" "never:always" "do:don't" "don't:do" "prefer:avoid"
+	                 "avoid:prefer" "enable:disable" "disable:enable" "keep:remove"
+	                 "remove:keep" "use:avoid" "avoid:use")
+
+	for pair in "${pairs[@]}"; do
+		local a="${pair%%:*}"
+		local b="${pair##*:}"
+
+		# Check if text1 has 'a' and text2 has 'b', or vice versa.
+		if [[ "$text1" == *"$a"* && "$text2" == *"$b"* ]]; then
+			return 0  # opposing
+		fi
+		if [[ "$text1" == *"$b"* && "$text2" == *"$a"* ]]; then
+			return 0  # opposing
+		fi
+	done
+
+	return 1  # not opposing
+}
+
+# Detect conflict state for a single proposal against a single existing memory.
+# Returns conflict classification and (optionally) the conflicting memory filename.
+#
+# Usage: librarian_conflict_check <proposal_body> <existing_memory_path> \
+#                                 <duplicate_threshold> <merge_threshold>
+#
+# Output: JSON object { conflict_state, conflicting_file (optional) }
+librarian_conflict_check() {
+	local proposal_body="$1"
+	local memory_path="$2"
+	local dup_threshold="${3:-0.7}"
+	local merge_threshold="${4:-0.45}"
+
+	[[ -z "$proposal_body" || -z "$memory_path" ]] && {
+		printf '%s' '{"conflict_state":"none"}'
+		return 0
+	}
+	[[ ! -f "$memory_path" ]] && {
+		printf '%s' '{"conflict_state":"none"}'
+		return 0
+	}
+
+	# Extract the body of the existing memory (skip frontmatter).
+	local existing_body
+	existing_body=$(awk '/^---$/{ if (++count == 2) { in_body = 1; next } }
+	                        in_body { print }' "$memory_path")
+
+	[[ -z "$existing_body" ]] && {
+		printf '%s' '{"conflict_state":"none"}'
+		return 0
+	}
+
+	# Normalize both bodies to token sets.
+	local prop_tokens existing_tokens
+	prop_tokens=$(_librarian_conflict_normalize "$proposal_body")
+	existing_tokens=$(_librarian_conflict_normalize "$existing_body")
+
+	# Compute Jaccard similarity.
+	local similarity
+	similarity=$(_librarian_conflict_jaccard "$prop_tokens" "$existing_tokens")
+
+	# Classify based on similarity + optional sentiment check.
+	if awk "BEGIN { exit !($similarity >= $dup_threshold) }"; then
+		# Definitely a duplicate.
+		jq -cn --arg file "$(basename "$memory_path")" \
+			'{ conflict_state: "duplicate", conflicting_file: $file }'
+	elif awk "BEGIN { exit !($similarity >= $merge_threshold) }"; then
+		# Merge candidate — significant overlap but not identical.
+		jq -cn --arg file "$(basename "$memory_path")" \
+			'{ conflict_state: "merge_candidate", conflicting_file: $file }'
+	elif awk "BEGIN { exit !($similarity >= $merge_threshold * 0.8) }"; then
+		# Check for opposing sentiment in the overlap zone.
+		if _librarian_conflict_opposing_sentiment "$proposal_body" "$existing_body"; then
+			jq -cn --arg file "$(basename "$memory_path")" \
+				'{ conflict_state: "conflict_candidate", conflicting_file: $file }'
+		else
+			printf '%s' '{"conflict_state":"none"}'
+		fi
+	else
+		# No meaningful overlap.
+		printf '%s' '{"conflict_state":"none"}'
+	fi
+}
+
+# Scan a proposal against all existing memories in the project.
+# Returns the highest-priority conflict found (duplicate > conflict > merge).
+#
+# Usage: librarian_conflict_scan <proposal_json> <memory_dir> \
+#                                <duplicate_threshold> <merge_threshold>
+#
+# Output: JSON object { conflict_state, conflict_with: [...] }
+librarian_conflict_scan() {
+	local proposal="$1"
+	local memory_dir="$2"
+	local dup_threshold="${3:-0.7}"
+	local merge_threshold="${4:-0.45}"
+
+	[[ -z "$proposal" || -z "$memory_dir" ]] && {
+		printf '%s' '{"conflict_state":"none","conflict_with":[]}'
+		return 0
+	}
+	[[ ! -d "$memory_dir" ]] && {
+		printf '%s' '{"conflict_state":"none","conflict_with":[]}'
+		return 0
+	}
+
+	local proposal_body
+	proposal_body=$(printf '%s' "$proposal" | jq -r '.proposed.body // ""')
+	[[ -z "$proposal_body" ]] && {
+		printf '%s' '{"conflict_state":"none","conflict_with":[]}'
+		return 0
+	}
+
+	local worst_state=""
+	local conflicts='[]'
+
+	# Scan all memory files in the project.
+	for memory_file in "$memory_dir"/*.md; do
+		[[ ! -f "$memory_file" ]] && continue
+
+		local check
+		check=$(librarian_conflict_check "$proposal_body" "$memory_file" \
+		                                  "$dup_threshold" "$merge_threshold")
+		[[ -z "$check" ]] && continue
+
+		local state
+		state=$(printf '%s' "$check" | jq -r '.conflict_state // "none"')
+		local filename
+		filename=$(printf '%s' "$check" | jq -r '.conflicting_file // ""')
+
+		# Track conflicts; prioritize by severity: duplicate > conflict > merge.
+		case "$state" in
+			duplicate)
+				worst_state="duplicate"
+				conflicts=$(printf '%s' "$conflicts" | jq --arg f "$filename" '. + [$f]')
+				;;
+			conflict_candidate)
+				if [[ "$worst_state" != "duplicate" ]]; then
+					worst_state="conflict_candidate"
+					conflicts=$(printf '%s' "$conflicts" | jq --arg f "$filename" '. + [$f]')
+				fi
+				;;
+			merge_candidate)
+				if [[ -z "$worst_state" ]]; then
+					worst_state="merge_candidate"
+					conflicts=$(printf '%s' "$conflicts" | jq --arg f "$filename" '. + [$f]')
+				fi
+				;;
+		esac
+	done
+
+	[[ -z "$worst_state" ]] && worst_state="none"
+	printf '%s' "$(jq -cn --arg state "$worst_state" --argjson files "$conflicts" \
+		'{ conflict_state: $state, conflict_with: $files }')"
+}